MCP 启动服务器

一个最小化的 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 桌面应用程序。

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

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

使用 Inspector 进行开发

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

访问 Inspector 文档 以获取详细的设置说明。

要在本地使用 Inspector 进行测试：

npm run inspect

要在文件更改时构建，请运行：

npm run watch

或者同时运行 watcher 和 inspector：

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