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

Related MCP server: mintlify-mcp

利用可能なツール

この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チャットをエージェントモードにし、「how many videos were published about JavaScript in 2024（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. 設定の編集をクリック

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"]
    }
  }
}

MCPHostとOllama（無料の代替手段）

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. "How many talks were given in 2023?（2023年には何件の講演が行われましたか？）"

2. "Show me talks in Spanish（スペイン語の講演を見せて）"

3. "Find posts about WebXR（WebXRに関する記事を探して）"

開発

特徴

• Model Context Protocol (MCP) で構築

• 完全なMCP機能: ツール、プロンプト、リソース

• TypeScriptとZodスキーマバリデーションによる型安全性

• トランスパイルなしのNode.jsでのネイティブTypeScriptサポート

• GenQL を使用した生成済みSDK

• 関心の分離によるモジュール式アーキテクチャ

• 容易な統合のための標準I/Oトランスポート

• 構造化されたエラーハンドリング

• 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 ファイルを参照してください。