内容
# MCP 工具部署模板
快速创建和部署您自己的 MCP 服务器的模板。它允许您：
1. 只需与 AI IDE 聊天，即可快速创建完全自定义的 MCP 服务器。
2. 从 MCP 市场向您的项目添加预先构建的开源 MCP 服务器。
该模板只需几步即可在 railway 上一次性部署所有内容！
## 🚀 逐步指南
### 前置条件
- Python 3.12+
- Git
## 步骤 0：复制模板
通过点击页面右上角的“使用此模板”按钮，复制此 GitHub 模板。
## 步骤 1：创建虚拟环境
**在 Cursor、Windsur 或 VS Code 中：**
1. 打开命令面板：
- 在 Mac 上：`Cmd + Shift + P`
- 在 Windows 上：`Ctrl + Shift + P`
2. 输入并选择：**Python: 选择解释器**
3. 点击：**+ 创建虚拟环境**
4. 选择：**Venv** 作为环境类型
**在终端中：**
```bash
python -m venv venv
source venv/bin/activate
```
## 步骤 2：创建您的工具
### 2.1 只需与 AI 聊天即可创建自定义工具
在聊天中提示您的 AI IDE 为您创建工具。**确保在上下文中包含 `./.cursor/rules/workflow.mdc`**。（仅在 Cursor 中默认包含）。
例如：
```
请创建一个从 YouTube 视频中获取转录的工具。@workflow.mdc
```
回答澄清问题，并不断迭代，直到工具创建并按预期工作。
确保将请求的任何环境变量添加到 `./.env` 文件中。
### 2.2 添加预构建的开源 Stdio MCP 服务器
将其他预先构建的开源 Stdio MCP 服务器添加到 `mcp.json` 文件中，类似于 Cursor 和其他客户端。
```json
{
"mcpServers": {
"notionapi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
# ... 在此处添加更多服务器
}
```
**只有 `Stdio` 服务器通过此方法支持。此存储库将自动使用 [supergateway](https://github.com/supercorp-ai/supergateway) 将它们转换为 SSE。**
您可以使用 npx 和 uv 运行这些服务器。
### 2.3 测试 MCP 服务器（可选）
运行以下命令来测试 MCP 服务器，并确保它们都正在运行。
此步骤不是必需的，因为如果您的工具正在工作，部署时应该不会出现问题。
```bash
npm run start
```
您无法将本地服务器连接到 Agencii，但可以通过将 SSE URL 添加到 Cursor 的“MCP 服务器”选项卡来测试它们。
此步骤不是必需的。只要您的工具没有问题，
## 步骤 3：部署到生产环境
1. 访问 [railway.com](https://railway.com)。
2. 创建一个新项目，并选择从 GitHub 部署。
3. 连接并选择您在步骤 1 中创建的 GitHub 仓库。
4. 点击部署。
如果出现问题，您可以通过点击最近的部署，然后点击“日志”选项卡，在 railway 上查看日志。
此模板将保持您的服务器冷启动，因此当不使用时，您无需支付任何费用！
## 步骤 4：复制您的 Railway 部署 URL
1. 进入设置 > 网络
2. 点击“生成域名”
3. 如有需要，选择端口 8080
4. 复制生成的 URL。
**`tools/` 文件夹中的 MCP 工具将可在以下地址访问：**
```
https://<railway-domain>/sse
```
**`mcp.json` 文件中的其他 MCP 服务器将可在以下地址访问：**
```
https://<railway-domain>/notionapi/sse
https://<railway-domain>/example-mcp-server/sse
```
## 步骤 5：将 MCP 服务器连接到 Agencii
1. 导航到 [Agencii 工具页面](https://agencii.ai/tools/)。
2. 点击“新建工具”
3. 选择“MCP”
4. 输入您的 MCP 服务器的 URL
5. 点击“同步工具”
6. 点击“保存”
7. 将您的工具添加到代理人。
我们建议再次复制此模板，并为每个新项目/客户端重复此过程。
---
**快乐构建！ 🚀**
