如何5分钟快速搭建mcp-use开发环境：终极一键部署脚本指南

如何5分钟快速搭建mcp-use开发环境终极一键部署脚本指南【免费下载链接】mcp-use项目地址: https://gitcode.com/gh_mirrors/mc/mcp-usemcp-use是一款功能强大的全栈MCP模型上下文协议框架专为构建AI代理、客户端和服务器而设计。这个开源项目提供了完整的Python和TypeScript SDK让开发者能够快速构建MCP应用支持ChatGPT、Claude等AI平台的无缝集成。无论你是AI开发者还是企业技术团队mcp-use都能为你提供高效的工具链和开发体验。 为什么选择mcp-use开发环境mcp-use不仅仅是一个框架更是一套完整的MCP生态系统解决方案。它提供了统一的开发体验支持Python和TypeScript双语言开发内置调试工具自动包含的Inspector面板让调试变得简单生产就绪内置认证、日志、监控等企业级功能社区活跃由Manufact团队维护拥有活跃的Discord社区图1mcp-use架构概览 - 展示客户端、网关和服务器之间的完整连接 环境要求与准备工作在开始之前请确保你的系统满足以下要求基础要求Python 3.11或Node.js 20.19Git版本控制系统pipPython包管理器或npm/pnpmNode.js包管理器可选组件Docker用于容器化部署虚拟环境工具venv、conda或virtualenv 一键部署脚本Python环境脚本代码创建一个名为setup_mcp_use.py的文件#!/usr/bin/env python3 mcp-use开发环境一键部署脚本 自动安装Python和TypeScript环境 import os import subprocess import sys import platform from pathlib import Path def run_command(cmd, cwdNone, shellTrue): 执行命令并打印输出 print(f 执行: {cmd}) result subprocess.run(cmd, shellshell, cwdcwd, capture_outputTrue, textTrue) if result.returncode ! 0: print(f❌ 错误: {result.stderr}) return False print(f✅ 成功: {result.stdout}) return True def check_python_version(): 检查Python版本 version sys.version_info if version.major 3 or (version.major 3 and version.minor 11): print(❌ Python版本需要3.11或更高) return False print(f✅ Python版本: {sys.version}) return True def setup_python_environment(): 设置Python环境 print(\n 设置Python开发环境...) # 创建虚拟环境 if not os.path.exists(venv): print( 创建Python虚拟环境...) if not run_command(python -m venv venv): return False # 激活虚拟环境仅Windows需要特殊处理 if platform.system() Windows: activate_cmd venv\\Scripts\\activate else: activate_cmd source venv/bin/activate # 升级pip pip_upgrade f{activate_cmd} python -m pip install --upgrade pip run_command(pip_upgrade) # 安装mcp-use及其开发依赖 install_cmd f{activate_cmd} pip install mcp-use[dev,anthropic,openai,search] if not run_command(install_cmd): return False # 克隆仓库如果不存在 if not os.path.exists(mcp-use): print( 克隆mcp-use仓库...) if not run_command(git clone https://gitcode.com/gh_mirrors/mc/mcp-use.git): return False # 安装本地开发版本 os.chdir(mcp-use/libraries/python) dev_install f{activate_cmd} pip install -e .[dev,anthropic,openai,e2b,search] if not run_command(dev_install): return False os.chdir(../..) return True def setup_typescript_environment(): 设置TypeScript环境 print(\n 设置TypeScript开发环境...) # 检查Node.js版本 node_check subprocess.run(node --version, shellTrue, capture_outputTrue, textTrue) if node_check.returncode ! 0: print(⚠️ Node.js未安装跳过TypeScript设置) return True # 安装pnpm如果未安装 if not run_command(npm list -g pnpm): print( 安装pnpm...) run_command(npm install -g pnpm) # 安装TypeScript依赖 if os.path.exists(mcp-use/libraries/typescript): os.chdir(mcp-use/libraries/typescript) if run_command(pnpm install): print(✅ TypeScript依赖安装完成) os.chdir(../..) return True def run_verification_tests(): 运行验证测试 print(\n 运行验证测试...) # Python测试 os.chdir(mcp-use/libraries/python) print( 运行Python单元测试...) run_command(source venv/bin/activate python -m pytest tests/unit/ -v) # TypeScript测试如果环境已设置 os.chdir(../../typescript/packages/mcp-use) if os.path.exists(node_modules): print( 运行TypeScript测试...) run_command(pnpm test:unit) os.chdir(../../../..) return True def create_example_project(): 创建示例项目 print(\n 创建示例项目...) examples_dir Path(mcp-use-examples) examples_dir.mkdir(exist_okTrue) # 创建Python示例 python_example examples_dir / python_example.py python_example.write_text( from mcp_use import MCPServer from typing import Annotated from pydantic import Field # 创建MCP服务器 server MCPServer(name快速开始示例, version1.0.0) server.tool( namegreet, description打招呼工具, ) async def greet( name: Annotated[str, Field(description用户名)] ) - str: return f你好{name}欢迎使用mcp-use if __name__ __main__: # 启动服务器自动包含Inspector server.run(transportstreamable-http, port8000) print( 服务器已启动: http://localhost:8000) print( Inspector面板: http://localhost:8000/inspector) ) # 创建TypeScript示例 ts_example examples_dir / typescript_example.ts ts_example.write_text( import { MCPServer, text } from mcp-use/server; import { z } from zod; const server new MCPServer({ name: quickstart-example, version: 1.0.0, }); server.tool({ name: greet, description: Say hello to someone, schema: z.object({ name: z.string() }), }, async ({ name }) { return text(Hello, ${name}! Welcome to mcp-use!); }); // 启动服务器 server.listen(3000).then(() { console.log( Server running at http://localhost:3000); console.log( Inspector available at http://localhost:3000/inspector); }); ) print(f✅ 示例项目已创建在: {examples_dir.absolute()}) def main(): 主函数 print( * 60) print( mcp-use开发环境一键部署脚本) print( * 60) # 检查Python版本 if not check_python_version(): sys.exit(1) # 设置Python环境 if not setup_python_environment(): print(❌ Python环境设置失败) sys.exit(1) # 设置TypeScript环境 setup_typescript_environment() # 运行验证测试 run_verification_tests() # 创建示例项目 create_example_project() print(\n * 60) print( mcp-use开发环境部署完成) print( * 60) print(\n 下一步操作) print(1. 激活虚拟环境:) print( Linux/Mac: source venv/bin/activate) print( Windows: venv\\Scripts\\activate) print(\n2. 运行Python示例:) print( cd mcp-use-examples python python_example.py) print(\n3. 运行TypeScript示例:) print( cd mcp-use-examples npx tsx typescript_example.ts) print(\n4. 访问Inspector面板:) print( http://localhost:8000/inspector (Python)) print( http://localhost:3000/inspector (TypeScript)) print(\n 更多文档请查看:) print( - Python文档: docs/python/) print( - TypeScript文档: docs/typescript/) print( - 示例代码: examples/) if __name__ __main__: main()使用说明保存脚本将上述代码保存为setup_mcp_use.py运行脚本在终端中执行python setup_mcp_use.py等待完成脚本会自动完成所有环境配置图2mcp-use开发环境 - 简洁高效的AI开发工具链️ 手动安装步骤备用方案如果自动脚本出现问题可以按照以下步骤手动安装Python环境安装# 1. 创建并激活虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac # 或 venv\Scripts\activate # Windows # 2. 安装mcp-use核心包 pip install mcp-use # 3. 安装开发依赖 pip install mcp-use[dev,anthropic,openai,search] # 4. 克隆仓库 git clone https://gitcode.com/gh_mirrors/mc/mcp-use.git cd mcp-use/libraries/python # 5. 安装本地开发版本 pip install -e .[dev,anthropic,openai,e2b,search]TypeScript环境安装# 1. 安装Node.js版本20.19 # 从官网下载https://nodejs.org/ # 2. 安装pnpm npm install -g pnpm # 3. 进入TypeScript目录 cd mcp-use/libraries/typescript # 4. 安装依赖 pnpm install # 5. 构建项目 cd packages/mcp-use pnpm build 验证安装结果安装完成后使用以下命令验证环境是否正常工作Python验证# 进入Python虚拟环境 source venv/bin/activate # 测试导入 python -c import mcp_use; print(✅ mcp-use导入成功:, mcp_use.__version__) # 运行简单测试 python -c from mcp_use import MCPServer server MCPServer(nametest, version1.0.0) print(✅ 服务器创建成功) TypeScript验证# 进入TypeScript项目目录 cd mcp-use/libraries/typescript/packages/mcp-use # 运行测试 pnpm test:unit # 构建检查 pnpm build图3mcp-use Inspector调试面板 - 实时监控MCP服务器连接状态 快速开始示例Python快速示例# quick_start.py from mcp_use import MCPServer from typing import Annotated from pydantic import Field # 创建服务器实例 server MCPServer( name天气预报服务, version1.0.0 ) # 添加工具 server.tool( nameget_weather, description获取城市天气信息, ) async def get_weather( city: Annotated[str, Field(description城市名称)] ) - str: # 这里可以集成真实的天气API return f{city}的天气晴25°C湿度60% # 启动服务器 if __name__ __main__: server.run(transportstreamable-http, port8000) print(️ 天气服务已启动) print( 访问: http://localhost:8000) print( Inspector: http://localhost:8000/inspector)TypeScript快速示例// quick_start.ts import { MCPServer, text } from mcp-use/server; import { z } from zod; const server new MCPServer({ name: weather-service, version: 1.0.0, }); server.tool({ name: get-weather, description: Get weather for a city, schema: z.object({ city: z.string() }), }, async ({ city }) { return text(Weather in ${city}: Sunny, 25°C, 60% humidity); }); // 启动服务器 server.listen(3000).then(() { console.log(️ Weather service started!); console.log( Visit: http://localhost:3000); console.log( Inspector: http://localhost:3000/inspector); }); 运行测试套件mcp-use提供了完整的测试套件确保代码质量Python测试# 运行所有测试 cd mcp-use/libraries/python pytest # 运行单元测试 pytest tests/unit/ # 运行集成测试 pytest tests/integration/ # 生成测试覆盖率报告 pytest --covmcp_use tests/TypeScript测试# 运行所有测试 cd mcp-use/libraries/typescript/packages/mcp-use pnpm test # 运行单元测试 pnpm test:unit # 运行集成测试 pnpm test:integration图4mcp-use代码模式演示 - 实时交互式开发体验 项目结构说明了解项目结构有助于更好地使用mcp-usemcp-use/ ├── libraries/ │ ├── python/ # Python SDK │ │ ├── mcp_use/ # 核心Python包 │ │ ├── examples/ # Python示例代码 │ │ └── tests/ # Python测试 │ └── typescript/ # TypeScript SDK │ ├── packages/ │ │ ├── mcp-use/ # 核心TypeScript包 │ │ ├── cli/ # 命令行工具 │ │ ├── inspector/ # 调试工具 │ │ └── examples/ # TypeScript示例 ├── docs/ # 文档 │ ├── python/ # Python文档 │ └── typescript/ # TypeScript文档 ├── examples/ # 综合示例 └── skills/ # AI技能模板 常用开发命令Python开发命令# 激活虚拟环境 source venv/bin/activate # 安装开发依赖 pip install -e .[dev,anthropic,openai,e2b,search] # 运行代码格式化 black . ruff check --fix # 运行类型检查 mypy mcp_use/ # 运行测试 pytest tests/ -vTypeScript开发命令# 安装依赖 pnpm install # 开发模式构建 pnpm build # 运行测试 pnpm test # 代码格式化 pnpm fmt # 运行示例 pnpm example:chat 常见问题解决1. Python版本问题症状ImportError或版本不兼容解决# 确认Python版本 python --version # 需要3.11 # 使用pyenv管理多个版本 pyenv install 3.11.0 pyenv local 3.11.02. 虚拟环境问题症状包安装失败或导入错误解决# 重新创建虚拟环境 rm -rf venv python -m venv venv source venv/bin/activate pip install --upgrade pip3. TypeScript构建错误症状pnpm build失败解决# 清理并重新安装 rm -rf node_modules pnpm install pnpm build4. 端口冲突症状服务器启动失败解决# 修改端口号 server.run(transportstreamable-http, port8080) # Python server.listen(8080) # TypeScript 性能优化建议开发环境优化使用缓存配置pip和pnpm使用国内镜像源增量构建TypeScript使用pnpm build --watch测试隔离使用pytest-xdist并行运行测试生产环境优化依赖最小化只安装必要的依赖包镜像构建使用Docker多阶段构建监控配置启用内置的监控和日志功能 开始你的第一个mcp-use项目现在你已经成功搭建了mcp-use开发环境可以开始构建强大的MCP应用了探索示例查看examples/目录中的丰富示例阅读文档访问docs/获取详细API文档加入社区在Discord中获取帮助和分享经验贡献代码查看CONTRIBUTING.md了解如何参与开发mcp-use的强大功能正在等待你的探索无论是构建AI代理、创建MCP服务器还是开发交互式应用这个框架都能为你提供完整的工具链和最佳实践。开始你的mcp-use开发之旅吧 官方文档路径Python文档docs/python/TypeScript文档docs/typescript/API参考libraries/python/mcp_use/示例代码examples/【免费下载链接】mcp-use项目地址: https://gitcode.com/gh_mirrors/mc/mcp-use创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考