MCP服务器生成器

一个基于GPT-4.1的AI工具,用于自动生成功能完整的Model Context Protocol (MCP)服务器,包括API封装、实用功能和数据生成器。

  • by dennisimoo
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dennisimoo/mcp-server-generator

使用说明

MCP服务器生成器

一个基于人工智能的工具,能够使用GPT-4.1自动创建模型上下文协议(MCP)服务器。

它的功能/作用

这个Python脚本利用GPT来创建功能齐全的MCP服务器。每台服务器都已准备好使用,并且可以连接到像Claude Desktop这样的AI工具。

生成器创建:

  • API封装器:连接到公共API(天气、笑话、趣事等)的服务器
  • 实用函数:数学运算、文本工具、数据处理
  • 数据生成器:随机数、UUID(通用唯一标识符)、模拟数据

每个生成的MCP(多载波聚合参数)包括:

  • 运行中的 Node.js 服务器代码
  • 完善 package.json 文件,包含所有依赖项
  • 包含说明的README文件
  • 错误处理和日志记录

快速入门

你所需要的

  • Python 3.8 或更高版本
  • Node.js 18 或更高版本
  • OpenAI API密钥

设置

  1. 安装Python依赖项:
pip install -r requirements.txt
  1. 创建你的 .env 文件:
cp .env.example .env
  1. 编辑.env文件并添加您的OpenAI API密钥:
OPENAI_API_KEY=sk-your-key-here
  1. (可选)启用npm自动发布:

编辑 .env 文件以添加:

NPM_AUTO_PUBLISH=true
NPM_USERNAME=your-npm-username
NPM_USE_SCOPED=true

在启用自动发布之前:

  • 在 https://www.npmjs.com/signup 进行注册
  • 运行:npm 登录
  • 验证:npm whoami(即检查当前npm用户的用户名)

运行生成器

python mcp_generator.py

当系统提示时,请输入您想要创建的服务器数量。

输出

生成的服务器保存在生成的_mcp文件夹中:

generated_mcps/
├── manifest.json
├── weather-mcp/
│   ├── index.js
│   ├── package.json
│   └── README.md
└── jokes-mcp/
    ├── index.js
    ├── package.json
    └── README.md

使用您生成的服务器

测试服务器

  1. 进入服务器文件夹:
cd generated_mcps/weather-mcp
  1. 安装依赖项:
npm install
  1. 运行它:
node index.js

连接到Claude桌面版

在你的 Claude 配置文件中添加(Mac 上的路径为:~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/full/path/to/generated_mcps/weather-mcp/index.js"]
    }
  }
}

重启Claude桌面程序后,您的工具将可用。

NPM 自动发布

启用后,生成器会自动将每个服务器发布到npm。这样,任何人都可以安装并使用您的服务器。

包名:

  • 当设置 NPM_USE_SCOPED=true 时:@username/weather-mcp
  • 当设置 NPM_USE_SCOPED=false 时:weather-mcp

发布后,任何人都可以通过以下方式安装:

npx @username/weather-mcp

它是如何工作的

  1. GPT-4.1提出了服务器方面的想法
  2. GPT-4.1编写了完整的代码
  3. 脚本保存所有文件
  4. (可选)发布到npm
  5. 创建 manifest.json 文件以追踪所有内容

小贴士

  • 从2-3台服务器开始,看看会创建出什么
  • 如果想要不同的想法,请再次运行
  • 编辑生成的代码以进行自定义
  • 使用作用域包(@username/name)以避免命名冲突
  • 将 NPM_AUTO_PUBLISH 设置为 false 以进行不发布测试

故障排除

未找到OPENAI_API_KEY

  • 请检查是否已使用您的API密钥创建了.env文件
  • 确保密钥以“sk-”开头

“生成MCP时出错”

  • 检查您的OpenAI API配额
  • 确保您能够访问GPT-4.1

生成的服务器无法工作

  • 进入服务器文件夹并运行:npm install
  • 查看服务器的README文件
  • 确保已安装 Node.js 18 或更高版本

NPM 发布失败

  • 检查你是否已登录:npm whoami
  • 包名可能已存在
  • 检查版本冲突

了解更多

  • 模型上下文协议:https://modelcontextprotocol.io/
  • MCP SDK:https://github.com/modelcontextprotocol/sdk
  • OpenAI API: https://platform.openai.com/docs

许可证

麻省理工学院许可证(MIT License)