MCP Templates (Maskdotdev)

MCP 模板

这个仓库包含用于构建的初始模板 模型上下文协议（MCP） 用TypeScript和Python编写的服务器。

模板

🔷 TypeScript 模板 (ts-mcp/）

一个具备文档搜索功能的完整MCP服务器实现，其特点包括：

• 文档搜索使用示例文档进行内存中的关键字搜索
• OpenAI兼容API与OpenAI、Ollama、LM Studio、Groq等更多平台兼容
• HTTP API用于测试和集成的REST端点
• 无外部依赖设置简便，无需向量数据库
• Bun 运行时使用 Bun 快速执行 TypeScript

快速入门：

cd ts-mcp
bun install
bun index.ts  # MCP server (stdio)
# or
bun server.ts # HTTP server for testing

🐍 Python 模板 (python-mcp/)

一个干净、可直接用于生产的模板，用于将Google ADK代理连接到MCP服务器：

• MCP 服务器带有ChromaDB语义搜索功能的FastMCP服务器
• ADK 代理消费MCP工具的Google ADK代理
• 语义搜索使用ChromaDB进行基于向量的文档搜索
• 简洁结构组织于 src/ 有明确的区分
• 已准备好投入生产STDIO 和 HTTP 传输支持

快速入门：

cd python-mcp
uv sync

# Terminal 1: Start MCP server
python src/server.py

# Terminal 2: Run agent example
python main.py

入门指南/开始使用

1. 选择您的模板根据您的喜好选择TypeScript或Python
2. 克隆并设置导航到您选择的模板，并按照其README文件中的说明操作
3. 定制根据您的特定使用场景调整工具和功能
4. 部署使用您喜欢的MCP客户端连接MCP服务器

MCP 集成

这两个模板都可以与MCP兼容的客户端集成。请使用以下方式配置您的客户端：

TypeScript：

{
  "command": "bun",
  "args": ["index.ts"],
  "cwd": "/path/to/ts-mcp"
}

python

{
  "command": "python",
  "args": ["src/server.py"],
  "cwd": "/path/to/mcp-template/python-mcp"
}

功能对比

| 架构 | 直接 | MCP 客户端-服务器 |

做出贡献

请随时提交问题和拉取请求以改进这些模板。

许可证