MCP Starter Server

MCP Starter Server

一个精简的 ModelContextProtocol 服务模板，可用于构建 AI 助手工具。此入门模板提供了基本结构，用于创建可供 Claude 等 AI 助手使用的 MCP 工具。

功能

• 简单的“hello world”工具示例
• TypeScript + esbuild 配置
• 预配置的开发工具

配置并运行 Claude

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

2. 克隆仓库、安装依赖并构建：

npm install
npm run build

3. 配置 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 的路径。

4. 重启 Claude Desktop。

5. 查看 Claude 界面中的锤子图标及其显示的可用工具数量，以确认服务正在运行。

6. 如果一切正常，你就可以使用 npm run dev 开发 MCP 服务，并在 Claude 中进行测试。每次重启 MCP 服务时，都需要重启 Claude。

使用 Inspector 进行开发

出于开发和调试的目的，你可以使用 MCP Inspector 工具。Inspector 提供了可视化界面，用于测试和监控 MCP 服务交互。

访问 Inspector 文档查看详细的配置说明。

使用 Inspector 在本地测试：

npm run inspect

文件发生更改时运行构建：

npm run watch

或者同时运行文件监视器和 Inspector：

npm run dev

发布

准备好分发你的服务后，发布过程很简单！

1. 注册一个 NPM 账号。

2. 运行 npm publish。这会使用 package.json 中的项目名称发布一个软件包。

3. 发布后，其他人可以通过如下配置条目安装此服务：

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

可用工具

此服务提供：

• hello_tool：一个简单的示例工具，接受名称参数并返回问候语

创建新工具

添加新工具：

1. 在 index.ts 中定义工具架构
2. 在 ListToolsRequestSchema 处理器的工具数组中添加该工具
3. 在 CallToolRequestSchema 处理器中添加实现

请参阅 hello_tool 的实现作为示例。