MCP Starter Server

一个用于构建AI助手工具的最小ModelContextProtocol服务器模板。此启动器提供了一个基本结构，用于创建可以与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 Desktop。

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

6. 如果一切正常，你可以使用npm run dev开发你的MCP服务器，并在Claude中测试它。每次需要重启MCP服务器时，都需要重启Claude。

使用Inspector进行开发

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

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

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