MCP服务器模板

用于快速构建Model Context Protocol服务器的生产就绪模板,支持TypeScript和Python语言。

  • by shellsage-ai
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 shellsage-ai/mcp-server-boilerplate

使用说明

MCP服务器主板

生产就绪的建筑入门模板 模型上下文协议 服务器在 TypeScript 和 python.

跳过样板。开始构建你的AI代理可以实际使用的工具。

服务器能力

此样板附带了所有三个MCP原语的工作示例:

工具

工具 说明 参数
echo 将消息回传给呼叫者 message (字符串,必填)
timestamp 获取当前UTC时间戳 (无)

资源

URI 描述 MIME类型
server://info 服务器元数据(名称、版本、可用工具) application/json

提示

启动器中没有注册提示模板。完整套件包括提示模板模式。

包含什么(免费)

TypeScript快速入门

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({
  name: "my-mcp-server",
  version: "1.0.0",
});

// Register a tool
server.tool("hello", { name: { type: "string" } }, async ({ name }) => ({
  content: [{ type: "text", text: `Hello, ${name}!` }],
}));

// Connect via stdio
const transport = new StdioServerTransport();
await server.connect(transport);

Python快速入门

from mcp.server import Server
from mcp.server.stdio import stdio_server

app = Server("my-mcp-server")

@app.tool()
async def hello(name: str) -> str:
    """Say hello to someone."""
    return f"Hello, {name}!"

async def main():
    async with stdio_server() as (read, write):
        await app.run(read, write)

Claude桌面配置

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"]
    }
  }
}

项目结构

my-mcp-server/
├── src/
│   └── index.ts          # Server entry point
├── tools/
│   └── example.ts        # Tool definitions
├── resources/
│   └── example.ts        # Resource providers
├── package.json
├── tsconfig.json
└── claude_desktop_config.json

入门指南

  1. 克隆此仓库
  2. npm install
  3. npm run build
  4. 添加到您的Claude桌面配置
  5. 开始构建工具

更进一步

这个免费的样板让你开始。这 MCP服务器主板套件 (49美元)包括:

  • ✅ 完整的TypeScript+Python双语言模板
  • ✅ 具有多阶段构建的Docker容器化
  • ✅ 用于自动化测试和部署的CI/CD管道(GitHub Actions)
  • ✅ 用于web部署的SSE(服务器发送事件)传输
  • ✅ 15+预构建工具示例(文件操作、API调用、数据库查询)
  • ✅ 资源和提示模板模式
  • ✅ 错误处理、日志记录和重试模式
  • ✅ 使用模拟MCP客户端测试框架
  • ✅ 生产部署指南(Docker、systemd、云)
  • ✅ 克劳德桌面+光标+Windsurf集成配置

获取全套装备→

资源

许可证

麻省理工学院——随心所欲地使用它。