MCP 启动服务器

一个用于构建 AI 助手工具的最小 ModelContextProtocol 服务器模板。此启动器为创建可以与 Claude 等 AI 助手一起使用的 MCP 工具提供了一个基本结构。

特性

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

设置以使用 Claude 构建和运行

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

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. 重启 Claude 桌面应用。

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

3. 如果一切正常，您应该能够使用 npm run dev 开发您的 MCP 服务器，并在 Claude 中进行测试。每次需要重启 Claude 才能重启 MCP 服务器。

使用 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 实现作为示例。