MCP Starter

🚀 MCP 启动服务器

MCP 启动服务器是一个用于构建 AI 助手工具的最小 模型上下文协议 服务器模板。它为创建与 AI 助手（如Claude）兼容的 MCP 工具提供了基本结构，能帮助开发者快速搭建相关项目。

🚀 快速开始

如果你想让 MCP 启动服务器与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。

✨ 主要特性

• 提供简单的 "你好，世界" 工具示例，方便开发者快速上手。
• 采用 TypeScript + esbuild 设置，提升开发效率和代码质量。
• 开发工具预配置，节省开发者的配置时间。

💻 使用示例

基础用法

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