AI助手工具服务器模板

MCP Starter Server是一个用于构建AI助手工具的最小化服务器模板,提供基本结构和开发工具,适用于与Claude等AI助手集成。

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

使用说明

MCP启动服务器

最低限度 模型上下文协议 用于构建AI辅助工具的服务器模板。该启动器为创建可与Claude等AI助手一起使用的MCP工具提供了一个基本结构。

特性

  • 简单的“hello world”工具示例
  • TypeScript+esb构建设置
  • 预配置的开发工具

与Claude一起构建和运行的设置

  1. 从下载并安装Claude桌面应用程序 claude.ai/下载

  2. 克隆仓库,安装依赖项并构建:

npm install
npm run build
  1. 配置Claude以使用此MCP服务器。如果这是您的第一台MCP服务器,请在此项目的根目录下运行:
echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

这应该会在您的 claude_desktop_config.json 比如:

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

如果您有现有的MCP服务器,请添加 mcp-starter 阻止您现有的配置。这是一个重要的细节 args 是通往 <path_to_repo_on_your_machine>/mcp-starter/dist/index.cjs.

  1. 重新启动克劳德桌面。

  2. 在Claude的界面中查找带有可用工具数量的锤子图标,以确认服务器正在运行。

  3. 如果一切正常,您应该能够使用以下工具开发MCP服务器 npm run dev 并在克劳德身上进行测试。每次重新启动MCP服务器时,您都需要重新启动Claude。

与Inspector共同发展

出于开发和调试目的,您可以使用MCP检查器工具。Inspector为测试和监控MCP服务器交互提供了一个可视化界面。

访问 检查员文件 有关详细的设置说明。

使用检验员进行本地测试:

npm run inspect

要基于文件更改进行构建,请运行:

npm run watch

或者同时运行监视器和检查器:

npm run dev

出版

一旦你准备好分发你的服务器,就很简单了!

  1. 设置一个 NPM 账户

  2. 跑 npm publish。这将在中使用项目名称发布包 package.json

  3. 发布后,其他人可以使用配置条目安装服务器,例如:

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

可用工具

服务器提供:

  • hello_tool:一个简单的示例工具,它接受name参数并返回问候语

创建新工具

要添加新工具,请执行以下操作:

  1. 在中定义工具模式 index.ts
  2. 将其添加到 ListToolsRequestSchema 处理器
  3. 将实现添加到 CallToolRequestSchema 处理器

请参阅 hello_tool 以实施为例。