Fist Maestro MCP Servers

🚀 MCP サーバープロジェクト

MCP（Model Context Protocol）サーバープロジェクトは、Cursor IDE のインテリジェント機能をサポートし、開発体験を向上させるためのさまざまなサービスを提供します。現在、サンプルサービスと天気サービスの 2 つの主要なサービスが含まれています。

✨ 主な機能

• サンプルサービスと天気サービスを提供し、Cursor IDE のインテリジェント機能をサポートします。
• サンプルサービスは、MCP サービスの基本構造と開発方法を示します。
• 天気サービスは、リアルタイムの天気情報を提供します。

📦 インストール

開発環境の要件

• Node.js バージョン 16.0 以上
• npm バージョン 8.0 以上
• TypeScript バージョン 4.5 以上
• 最新バージョンの Cursor IDE

インストール手順

1. プロジェクトをクローンする

git clone <repository-url>
cd mcp-servers

2. 依存関係をインストールする

npm install

3. プロジェクトをビルドする

• すべてのサービスをビルドする：

npm run build

• 特定のサービス（例：天気サービス）を個別にビルドする：

npm run build:weather

4. MCP を設定する

~/.cursor/mcp.json ファイルを編集し、以下の内容を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "/your/path/to/mcp-servers/build/weather/index.js"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. サービスを起動する

• 天気サービスを起動する：

npm run start:weather

• サンプルサービスを起動する：

npm run start:demo

💻 使用例

サンプルサービス（Demo）

• 位置：src/demo/
• 機能：MCP サービスの基本構造と開発方法を示します。
• 特徴：
  • シンプルなリクエストとレスポンスの例
  • 基本的なエラー処理
  • 完全なコードコメント付きで、学習に最適

天気サービス（Weather）

• 位置：src/weather/
• 機能：世界中の天気情報を提供します。
• 特徴：
  • リアルタイムの天気情報を取得できます。
  • 未来 5 日間の天気予報を提供します。
  • 複数の都市を同時に検索できます。
  • 詳細な天気データを提供します。

📚 ドキュメント

新しいサービスの作成

1. src ディレクトリに新しいサービスディレクトリ（例：new-service）を作成します。
2. 既存のサービス（例：demo または weather）の構造をコピーし、必要に応じて調整します。
3. 必要なコントローラーとサービスロジックを実装します。
4. プロジェクトのルートディレクトリにある package.json に、対応するビルドと起動スクリプトを追加します。

デバッグ方法

1. console.error() を使用してデバッグ情報を出力します。
2. Cursor IDE の MCP ログウィンドウを確認します。
3. TypeScript のソースマッピング機能を利用してデバッグします。

テスト方法

• すべてのテストを実行する：

npm test

• 特定のサービス（例：天気サービス）のテストを個別に実行する：

npm test weather

❓ よくある質問

サービスが起動しない場合

• ポートが使用中でないことを確認してください。
• 環境変数が正しく設定されていることを確認してください。

API 呼び出しが失敗する場合

• API キーが有効であることを確認してください。
• ネットワーク接続が正常であることを確認してください。

Cursor IDE がサービスを認識しない場合

• MCP 設定ファイル mcp.json が正しく設定されていることを確認してください。
• Cursor IDE を再起動し、プロジェクトを再読み込みしてください。

🤝 貢献方法

1. このプロジェクトをあなたの GitHub アカウントに Fork します。
2. 新しい機能を開発するか、問題を修正するための新しいブランチを作成します。

git checkout -b feature/new-service

3. コードをコミットし、リモートリポジトリにプッシュします。

git push origin feature/new-service

4. メインブランチに Pull Request を送信します。

📞 連絡先

さらなる支援が必要な場合や問題をフィードバックする場合は、プロジェクトのメンテナに連絡してください。

• メール：contact@example.com
• GitHub：あなたのGitHubリンク

MCP サーバープロジェクトにご関心をいただき、ありがとうございます！