Advocu MCP Server

🚀 Activity Reporting MCP Server

このプロジェクトは、AIによる会話型インターフェースを通じて、Google Developer Experts (GDEs) が簡単に活動を報告できるようにします。Advocu APIをModel Context Protocol (MCP) と統合することで、GDEsはコンテンツ作成、講演、ワークショップ、メンタリングセッションなどの活動を、AIチャットモデルやコマンドラインツールを通じて直接送信できるようになりまし。これにより、報告プロセスが合理化され、より直感的かつアクセスしやすくなり、GDEプログラムが必要とする詳細な追跡を維持します。

これは、Advocu GDE APIに活動を報告するためのModel Context Protocol (MCP) サーバーです。

🚀 クイックスタート

📦 インストール

NPMを使用する場合

npm install -g advocu-mcp-server

npxを使用する場合 (推奨: インストール不要)

npx advocu-mcp-server

⚙️ 設定

前提条件

• Node.js 18+
• Advocu GDE APIアクセストークン

ステップ1: Claude Desktopの設定

Claude Desktopの設定ファイルを編集します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

オプションA: グローバルインストールを使用する場合

{
  "mcpServers": {
    "activity-reporting": {
      "command": "advocu-mcp-server",
      "env": {
        "ADVOCU_ACCESS_TOKEN": "your_advocu_token_here"
      }
    }
  }
}

オプションB: npxを使用する場合

{
  "mcpServers": {
    "activity-reporting": {
      "command": "npx",
      "args": ["-y", "advocu-mcp-server"],
      "env": {
        "ADVOCU_ACCESS_TOKEN": "your_advocu_token_here"
      }
    }
  }
}

ステップ2: Claude Desktopを再起動

Claude Desktopを閉じて再度開き、新しい設定を読み込みます。

🔧 ローカル開発環境のセットアップ

サーバーに貢献したり、変更を加えたい場合は、以下の手順を実行します。

git clone https://github.com/carlosazaustre/advocu-mcp-server.git
cd advocu-mcp-server
npm install
npm run build

その後、Claude Desktopをローカルパスで設定します。

{
  "mcpServers": {
    "activity-reporting": {
      "command": "node",
      "args": ["/absolute/path/to/advocu-mcp-server/dist/index.js"],
      "env": {
        "ADVOCU_ACCESS_TOKEN": "your_advocu_token_here"
      }
    }
  }
}

💻 利用可能なツール

設定が完了すると、Claudeで以下のツールを使用できます。

• submit_content_creation - コンテンツ作成活動を報告する
• submit_public_speaking - 講演活動を報告する
• submit_workshop - ワークショップセッションを報告する
• submit_mentoring - メンタリング活動を報告する
• submit_product_feedback - 製品フィードバックの提出を報告する
• submit_googler_interaction - Google社員とのやり取りを報告する
• submit_story - 成功事例を報告する

💻 使用例

Claudeでは、以下のようなコマンドを使用できます。

"Submit a content creation activity for my blog post about React hooks published on Medium"

"Create a public speaking draft for my presentation at ReactConf 2024"

"Report a mentoring session I had with 3 junior developers about TypeScript"

📚 ドキュメント

すべての利用可能なエンドポイント、パラメータ、およびデータ形式の詳細情報については、APIドキュメント を参照してください。

🔧 開発

開発モード

npm run dev

ビルド

npm run build

リントとフォーマット

npm run lint
npm run format

⚠️ レート制限

APIには1分あたり30リクエストの制限があります。サーバーは自動的に429エラーを処理します。

📁 プロジェクト構造

advocu-mcp-server/
├── src/
│   ├── index.ts                    # エントリーポイント
│   ├── server.ts                   # メインサーバークラス
│   ├── interfaces/                 # 活動ドラフトインターフェース
│   │   ├── ActivityDraftBase.ts
│   │   ├── ContentCreationDraft.ts
│   │   ├── GooglerInteractionDraft.ts
│   │   ├── MentoringDraft.ts
│   │   ├── ProductFeedbackDraft.ts
│   │   ├── PublicSpeakingDraft.ts
│   │   ├── StoryDraft.ts
│   │   └── WorkshopDraft.ts
│   └── types/                      # 型定義
│       ├── ContentType.ts
│       ├── Country.ts
│       ├── EventFormat.ts
│       ├── InteractionFormat.ts
│       ├── InteractionType.ts
│       ├── ProductFeedbackContentType.ts
│       ├── SignificanceType.ts
│       └── Tag.ts
├── dist/                           # コンパイルされた出力
├── docs/                           # ドキュメント
│   └── API.md
├── package.json
├── tsconfig.json
└── README.md

🛠️ トラブルシューティング

エラー: "Command not found"

• claude_desktop_config.json のパスが絶対パスであることを確認してください。
• ファイルが実行可能であることを確認してください: chmod +x dist/index.js

エラー: "Authentication failed"

• .env ファイル内のトークンが正しいことを確認してください。
• トークンがPersonal APIに対する権限を持っている必要があります。

エラー: "ADVOCU_ACCESS_TOKEN is not set"

• プロジェクトルートに .env ファイルが存在することを確認してください。
• .env ファイル内でトークンが正しく設定されていることを確認してください。

エラー: "Rate limit exceeded"

• 1分間待ってから再度リクエストを行ってください。
• APIは1分あたり30リクエストに制限されています。

🤝 貢献方法

1. プロジェクトをフォークします。
2. 新しい機能ブランチを作成します: git checkout -b feature/new-feature
3. 変更をコミットします: git commit -am 'Add new feature'
4. ブランチにプッシュします: git push origin feature/new-feature
5. プルリクエストを作成します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。