MCP Starter

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