MCP Hatchery

MCP孵化场🥚

一个CLI工具，用于构建模型上下文协议（MCP）服务器，支持：

• JavaScript：在Netlify/Vercel主机上使用@modelcontextprotocol/sdk
• python：使用FastMCP框架和可选的FastMCP云托管

安装

npm install -g mcp-hatchery

用法

mcp-hatchery create my-server

或者直接与npx一起使用：

npx mcp-hatchery create my-mcp-server

系统将提示您输入项目名称和描述。该工具生成了一个完整的MCP服务器，其中包含可供定制的示例工具。

项目类型

JavaScript（裸骨）

使用官方JavaScript SDK的MCP服务器：

• IDE集成的本地stdio传输
• Netlify或Vercel的远程HTTP/SSE传输
• Zod模式验证示例工具
• 使用@modelcontextprotocol/sdk

Python（FastMCP）

使用FastMCP Python框架的MCP服务器：

• 带有示例查询工具的数据驱动服务器
• IDE集成的本地stdio支持
• 可选远程部署到FastMCP Cloud
• 包括测试脚本和全面的README
• 使用fastmcp>=2.0.0

生成的项目结构

JavaScript项目

my-mcp-server/
├── src/
│   ├── index.js       # Local MCP server (stdio transport)
│   └── tools.js       # Tool definitions with Zod schemas
├── netlify/
│   └── functions/
│       └── api.js     # Netlify Function (SSE transport)
├── data/              # Optional data files for your tools
├── package.json
├── netlify.toml
└── README.md

• src/tools.js --在此处定义您的MCP工具（名称、描述、模式、处理程序）
• src/index.js --用于本地IDE集成的Stdio服务器
• netlify/functions/api.js --用于远程部署的SSE服务器
• 数据/ --存储您的工具需要访问的静态数据文件

FastMCP项目

my-fastmcp-server/
├── server.py          # FastMCP server with sample tools
├── requirements.txt   # Python dependencies
├── test_server.py     # Validation script
├── data/
│   └── sample.json    # Sample data file
└── README.md          # Deployment guide

• 服务器.py --带示例数据查询工具的FastMCP服务器
• test_server.py --验证功能的测试脚本
• data/sample.json --示例数据结构
• 需求.txt --Python依赖项（fastmcp>=2.0.0）

IDE配置

添加到IDE的MCP设置中：

JavaScript（本地）：

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/absolute/path/to/my-mcp-server/src/index.js"]
    }
  }
}

Python（本地）：

{
  "mcpServers": {
    "my-fastmcp-server": {
      "command": "python",
      "args": ["/absolute/path/to/my-fastmcp-server/server.py"]
    }
  }
}

远程（Netlify部署后）：

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["mcp-remote@next", "https://my-server.netlify.app/mcp"]
    }
  }
}

远程（FastMCP云部署后）：

{
  "mcpServers": {
    "my-fastmcp-server": {
      "type": "http",
      "url": "https://your-project-name.fastmcp.app/mcp"
    }
  }
}

部署到Netlify

通过GitHub

1. 将您的项目推送到GitHub
2. 首选 Netlify → “添加新网站”→ “导入现有项目”
3. 连接您的存储库——Netlify自动检测来自以下位置的设置 netlify.toml

通过CLI

npm install -g netlify-cli
netlify login
netlify deploy --prod

端点

部署后：

• 上海证券交易所: https://your-site.netlify.app/.netlify/functions/api/sse
• 消息: https://your-site.netlify.app/.netlify/functions/api/message

然后重建： npm run build

部署到FastMCP云

对于使用FastMCP选项生成的Python项目：

1. 将您的项目推送到GitHub
2. 访问 fastmcp.cloud 并使用GitHub登录
3. 从存储库创建新项目
4. 配置：

- 名字：选择一个唯一的名称（创建URL） - 入口点: server.py:mcp - 认证：仅限公众或组织

1. 部署（自动）
2. 连接地址： https://your-project-name.fastmcp.app/mcp

每次推送时，FastMCP Cloud都会自动重新部署 main.

需求

• Node.js>=18.0.0（适用于JavaScript项目）
• Python>=3.8（适用于FastMCP项目）

许可证

麻省理工学院