AI导哈

MCP服务器模板

提供TypeScript和Python的MCP服务器模板，支持文档搜索和API集成，适用于快速构建MCP兼容服务器。

  • by maskdotdev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 maskdotdev/mcp-templates

使用说明

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"
}

功能对比

特性 TypeScript Python
中文翻译 中文对应内容 中文翻译
运行时 Bun Python 3.10+
框架 自定义 FastMCP + Google ADK
依赖项 最小配置 FastMCP + ChromaDB
设置复杂度 简单 简单
向量搜索 否 是（ChromaDB）
传输 STDIO STDIO + HTTP
代理集成 不适用 Google ADK（Google开发者工具包）

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

做出贡献

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

许可证

相关 MCP