MCP 启动服务器

一个用于构建 AI 助手工具的最小 模型上下文协议 服务器模板。此启动器提供了一个基本结构，可用于创建与 AI 助手（如Claude）兼容的 MCP 工具。

特性

• 简单的 "你好，世界" 工具示例
• TypeScript + esbuild 设置
• 开发工具预配置

设置以构建和运行与Claude一起使用

1. 下载并安装 Claude Desktop 应用

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 进行开发并在 Claude 中测试。每次需要重新启动 MCP 服务器时都需要重新启动 Claude。

使用 Inspector 开发

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

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

要本地测试：

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：一个简单的示例工具，带有一个名称参数并返回问候语。

创建新工具

要添加新的工具：

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

查看 hello_tool 的实现作为示例。