erickwendel-contributions-mcp

erickwendel-contributions-mcp

Erick Wendel の貢献について、さまざまなプラットフォームを横断して問い合わせるためのツールを提供する Model Context Protocol（MCP）サーバーです。Claude、Cursor などを通じて自然言語で、講演、ブログ記事、動画について問い合わせることができます。このプロジェクトは、デフォルトのエージェント（試用版）を使用してCursor IDE で構築されました。

クイックスタート

インストールせずに、この MCP サーバーを Claude Desktop または Cursor で直接使用できます。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

次のファイルにこの設定を追加してください。

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
• Cursor：~/.cursor/mcp.json

利用可能なツール

この MCP サーバーでは、次の機能を利用できます。

ツール

• get-talks：オプションのフィルタリングを指定して、講演のページ分割された一覧を取得します

  • ID、タイトル、言語、都市、国、年によるフィルタリングに対応しています
  • 言語、国、都市ごとにグループ化した件数を返すことができます

• get-posts：オプションのフィルタリングとページ分割を指定して、投稿を取得します

  • ID、タイトル、言語、ポータルによるフィルタリングに対応しています

• get-videos：オプションのフィルタリングとページ分割を指定して、動画を取得します

  • ID、タイトル、言語によるフィルタリングに対応しています

• check-status：API が稼働し、応答しているかを確認します

プロンプト

• find-content：種類、トピック、言語を指定して特定のコンテンツを見つけるためのクエリを生成します
• summarize-activity：年ごとのコンテンツの活動状況をまとめます

リソース

• erickwendel://about：サーバー情報と機能のメタデータ
• erickwendel://statistics：コンテンツの統計情報と利用可能なクエリ

AI ツールとの連携

MCP サーバーの機能を確認する

MCP Inspector を使って、この MCP サーバーの機能を確認できます。

npm run inspect

利用可能なすべてのツール、そのパラメーター、使用方法が表示されます。

セットアップ

1. Node.js v20 以降を使用していることを確認します

node -v
# v20.x.x or higher

2. このリポジトリをクローンします。

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. 依存関係をインストールします。

npm ci

4. サーバーを実行します。

npm start

AI ツールとの連携

Cursor のセットアップ

次の設定を ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

左下のドロップダウンから「Agent」を選択して Cursor のチャットを Agent モードにし、「2024 年に JavaScript について何本の動画が公開されましたか」と質問してください。

ローカル開発

ローカル開発では、プロジェクトの絶対パスを使用してください。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Claude Desktop のセットアップ

1. Claude の設定を開きます
2. Developer タブをクリックします
3. edit config をクリックします
4. コードエディターで設定ファイルを開きます
5. 次の設定を ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）に追加します。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

ローカル開発

ローカル開発では、プロジェクトの絶対パスを使用してください。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Ollama で MCPHost を使用する（無料の代替手段）

Claude Desktop または Cursor を利用できない場合は、無料の代替手段として MCPHost を Ollama と組み合わせて使用できます。

1. MCPHost をインストールします。

go install github.com/mark3labs/mcphost@latest

2. 設定ファイルを作成します（例：./mcp.jsonc）。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

3. Ollama で実行します。

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

ローカル開発

ローカル開発では、設定を更新します。

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

クエリの例

Claude、Cursor、または任意の MCP クライアントに質問できるクエリの例を紹介します。

1. 「2023 年に講演は何回行われましたか？」

2. 「スペイン語の講演を表示してください」

3. 「WebXR に関する投稿を見つけてください」

開発

特長

• Model Context Protocol（MCP）で構築
• MCP の全機能：ツール、プロンプト、リソース
• TypeScript と Zod のスキーマ検証による型安全性
• トランスパイルなしで Node.js のネイティブ TypeScript をサポート
• GenQL を使用して SDK を生成
• 関心事を分離したモジュラーアーキテクチャ
• 簡単に統合できる標準入出力トランスポート
• 構造化されたエラー処理
• Claude Desktop、Cursor、MCPHost（無料の代替手段）に対応

注：このプロジェクトでは、昨年追加されたネイティブ TypeScript サポートを使用しているため、Node.js v23 以降が必要です。

アーキテクチャ

コードベースはモジュラー構造を採用しています。

src/
  ├── config/      # Configuration settings
  ├── types/       # TypeScript interfaces and types
  ├── tools/       # MCP tool implementations
  ├── utils/       # Utility functions
  ├── services/    # API service layer
  └── index.ts     # Main entry point

テスト

テストスイートを実行するには：

npm test

ウォッチ付きの開発モードで実行するには：

npm run test:dev

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

作者

Erick Wendel

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。