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 が表示されます。