Connpass User
    Connpass User

    Connpass User

    Model Context Protocol server that provides connpass users API v2

    4.3

    GitHub Stats

    Stars

    3

    Forks

    2

    Release Date

    4/27/2025

    about 2 months ago

    Detailed Description

    Connpassのユーザー情報や参加イベント情報等を取得するModel Context Protocol (MCP)サーバーです。

    セットアップ

    1. (Connpass APIキーをすでに取得済の場合はスキップ)Connpass APIキーの発行をしてもらいます。詳細についてはconnpassのAPI利用についてを参照してください。
    2. このリポジトリをクローンします。
    3. 必要な環境変数を設定します。.env.example.env にコピーして、Connpass APIキーを設定します。
    cp .env.example .env
    # .envファイルを編集してCONNPASS_API_KEYを設定
    
    1. サーバーを起動します。

    Denoでの起動(推奨)

    "connpass-user-mcp-server": {
      "command": "wsl.exe",
      "args": [
        "/home/user/.deno/bin/deno",
        "--allow-net=connpass.com",
        "--env-file=/home/user/connpass-mcp-server/.env",
        "--allow-read",
        "--allow-env",
        "/home/user/connpass-mcp-server/index.ts"
      ]
    }
    

    Node.jsでの起動

    1. MCPサーバーを起動するために必要な依存関係をインストールします。
    npm ci
    
    1. TypeScriptをビルドします。
    npm run build
    
    1. MCPクライアントの設定ファイル側にビルドしたファイルを指定します。
    "connpass-user-mcp-server": {
      "command": "wsl.exe",
      "args": [
        "/home/user/.local/share/mise/installs/node/22.14.0/bin/node",
        "--env-file=/home/user/connpass-mcp-server/.env",
        "/home/user/connpass-mcp-server/dist/index.js"
      ]
    }
    

    Dockerでの起動

    Dockerfileを使用してサーバーを起動することもできます。

    1. Dockerイメージをビルドします。
    docker build -t connpass-user-mcp-server .
    
    1. コンテナを起動します。APIキーは環境変数として渡します。
    docker run -e CONNPASS_API_KEY=XXXXXXXXXXXXXXXX connpass-user-mcp-server
    

    MCPクライアントの設定ファイルでは、dockerコマンドを指定します。

    "connpass-user-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "CONNPASS_API_KEY=XXXXXXXXXXXXXXXX",
        "connpass-user-mcp-server"
      ]
    }
    

    npxでの起動(非推奨)

    @yamanoku/connpass-user-mcp-serverにてパッケージを提供しているため、リポジトリをクローンせずにnpxでMCPサーバーの起動が可能です。

    "connpass-user-mcp-server": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "CONNPASS_API_KEY=XXXXXXXXXXXXXXXX /home/user/.local/share/mise/installs/node/22.14.0/bin/npx -y @yamanoku/connpass-user-mcp-server",
      ]
    },
    

    ただしnpxでMCPサーバーを起動するのはサプライチェーン攻撃などのセキュリティ的な懸念があるため非推奨としています。

    機能

    以下のMCPサーバーのToolsを提供しています:

    Tools

    • get_connpass_user_list - Connpassユーザーの基本情報を取得します

      • パラメータ: nickname (Connpassユーザー名/ニックネームの配列)
      • 取得情報: 参加イベント数、管理イベント数、発表イベント数、ブックマークイベント数
    • get_connpass_user_group_list - Connpassユーザーが所属するグループ一覧を取得します

      • パラメータ: nickname (Connpassユーザー名/ニックネーム)
      • 取得情報: グループ名、URL、説明、参加者数など
    • get_connpass_user_events - Connpassユーザーが参加したイベント情報を取得します

      • パラメータ: nickname (Connpassユーザー名/ニックネーム)
      • 取得情報: イベント名、日時、場所、URL、説明
    • get_connpass_user_presenter_events - Connpassユーザーが発表者として参加したイベント情報を取得します

      • パラメータ: nickname (Connpassユーザー名/ニックネーム)
      • 取得情報: イベント名、日時、場所、URL、説明

    プロンプト例

    次のようなプロンプトをLLMへ渡すことが可能です:

    • 「yamanoku, okuto_oyamaさんのConnpassユーザー情報を教えて」
    • 「yamanokuさんの参加するConnpassイベント情報を教えて」
    • 「yamanokuさんの発表したConnpassイベント一覧を表示して」
    • 「yamanokuさんのConnpass所属グループを一覧表示して」

    テスト

    Denoでのテスト

    Connpass APIの統合テストを実行します:

    deno task test
    

    謝辞

    このOSSはGPT-4o Image Generationによってロゴを製作、Claude 3.7 Sonnetによって実装、ドキュメントのサンプルを提案いただきました。感謝申し上げます。

    ライセンス

    MIT License

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.