AI导哈

MCP服务器启动工具包

一个基于TypeScript的Model Context Protocol服务器启动工具包，帮助开发者快速构建自定义AI工具，支持数据库查询、API调用、文件操作等功能。

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

使用说明

MCP服务器入门套件

最低限度 模型上下文协议 TypeScript中的服务器启动器。在几分钟内构建自定义AI工具。

MCP让像Claude和Cursor这样的人工智能助手调用你的代码——数据库查询，API调用，文件操作，任何你可以编写函数的东西。这个启动器为您提供了一个工作服务器，所有东西都连接好了，这样您就可以跳过样板并开始构建。

快速开始

git clone https://github.com/tysoncung/mcp-server-starter.git
cd mcp-server-starter
npm install

在开发模式下运行（热重新加载）：

npm run dev

就是这样。您的MCP服务器正在运行。

里面是什么

一个示例工具(echo)它演示了定义MCP工具的模式：

server.tool(
  'echo',                                           // Tool name
  'Echo back the provided message',                 // Description for the AI
  { message: z.string().describe('Message text') }, // Input schema (Zod)
  async ({ message }) => {                          // Handler
    return { content: [{ type: 'text', text: `Echo: ${message}` }] };
  },
);

要添加自己的工具，请按照中的相同模式 src/server.ts.定义一个名称，描述它的作用，用Zod声明输入，并编写处理程序。

添加到克劳德桌面

先构建项目：

npm run build

编辑您的Claude Desktop配置文件：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "starter": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-starter/dist/index.js"]
    }
  }
}

重新启动Claude Desktop，您的工具将可用。

添加到光标

打开光标设置→ MCP → 添加服务器或编辑 .cursor/mcp.json 在您的项目中：

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

脚本

命令 描述
npm run dev 从热重新加载开始（tsx手表）
npm run build 将TypeScript编译为 dist/
npm start 运行编译后的输出
npm test 运行测试

项目结构

src/
├── server.ts              # Server setup & tool definitions
├── index.ts               # Entry point (stdio transport)
└── __tests__/
    └── server.test.ts     # Tool tests

需求

  • Node.js≥20
  • npm

想要更多？ 🚀

这个免费的入门工具可以让你使用一个示例工具和stdio传输来启动和运行。这 专业入门套件 为您提供运送生产MCP服务器所需的一切：

自由 专业版
工具 1个示例 5个生产就绪模板
工具模板 - 数据库、REST API、文件系统、web scraper、代码运行器
传输 stdio stdio+SSE（远程客户端）
身份验证 - neneneba API密钥+JWT中间件
速率限制 -- ✅ 内置
日志 -- 结构化日志中间件
测试 基础 使用Vitest的完整测试套件
Docker -- Dockerfile+Docker组合
部署 -- AWS CDK基础架构
错误处理 基本 生产级重试
Linting -- ESLint+预处理配置

Pro中有什么？

  • 5个工具模板 您可以复制和自定义——不仅仅是echo，还可以复制数据库、REST API、文件系统、web抓取和代码执行的真实模式
  • 双重运输 --通过stdio为本地用户提供服务，通过SSE为远程客户端提供服务，两者都来自同一代码库
  • 身份验证中间件 -API密钥和JWT认证开箱即用
  • 速率限制 --保护您的服务器免受失控的AI请求
  • 结构化日志记录 --确切地知道你的服务器在生产中做什么
  • Docker+AWS CDK --只需一个命令即可部署到任何地方
  • 完整的测试套件 --每个工具都经过测试，CI就绪

👉 获取专业入门套件——49美元→

跳过几个小时的设置。从今天开始构建生产MCP工具。

许可证

麻省理工学院——见 许可证

📖 阅读完整故事

我构建了一个生产MCP服务器套件——这是我学到的 --设计决策、架构和构建生产MCP服务器的经验教训。

相关 MCP