MCP Servers Collection

MCP 服务集合

此代码库包含一组 Model Context Protocol（MCP）服务，旨在与各种外部服务交互。这些服务允许 Claude 等语言模型访问这些服务的实时数据和功能。

包含的服务

此代码库目前包含以下 MCP 服务：

1. navitime-transit-server/

   • 使用 Navitime API 提供公交路线信息。
   • 支持查询列车时刻表、票价和换乘信息。
   • 详细的设置和使用说明，请参阅 navitime-transit-server/README.md。

2. googlemaps-directions-server/

   • 使用 Google Maps Directions API 提供驾车、步行和骑行路线。
   • 需要配置有效的 Google Maps API 密钥。
   • 详细的设置和使用说明，请参阅 googlemaps-directions-server/README.md。

3. places-server/

   • 提供地点信息，例如地址、电话号码、评分和评论（可能使用 Google Places API）。
   • 需要配置有效的 Google Places API 密钥。
   • 详细的设置和使用说明，请参阅 places-server/README.md。

常规开发

每个服务都是独立的 Node.js（TypeScript）项目。要开发或构建特定服务：

1. 进入服务目录：

   cd <server-directory-name> # e.g., cd navitime-transit-server
   

2. 安装依赖：

   npm install
   

3. 构建服务：

   npm run build
   

4. 在开发期间启用自动重新构建（如果可用）：

   npm run watch
   

与 Claude Desktop 搭配使用

要将这些服务与 Claude Desktop 搭配使用，需要将其配置添加到 claude_desktop_config.json 文件中。

• MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%/Claude/claude_desktop_config.json

在 mcpServers 对象中，为要使用的每个服务添加条目。请务必将 /path/to/repo/... 替换为系统上已构建服务文件的实际绝对路径。

{
  "mcpServers": {
    "navitime-mcp": {
      "command": "/path/to/repo/navitime-transit-server/build/index.js"
    },
    "gmaps-directions-mcp": {
      "command": "/path/to/repo/googlemaps-directions-server/dist/index.js" // Adjust path if needed
    },
    "places-mcp": {
      "command": "/path/to/repo/places-server/dist/index.js" // Adjust path if needed
    }
    // Add other servers here if needed
  }
}

注意： 具体的命令路径可能因各服务的构建输出配置（tsconfig.json、package.json）而异。请在构建输出目录（通常为 build/ 或 dist/）中确认主 JavaScript 文件（例如 index.js）的正确路径。

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector。通常可以在每个服务的目录中运行：

npm run inspector # If the script is defined in package.json

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。