Skip to main content
Glama
connpass-user-mcp-server

connpass-user-mcp-server

by yamanoku

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/24.18.1/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/24.18.1/bin/npx -y @yamanoku/connpass-user-mcp-server",
  ]
},

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

Related MCP server: Connpass MCP Server

機能

以下の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

Available Tools

4 tools
get_connpass_user_eventsC

Fetch events for a specific Connpass user

Inputs: nickname (required).

get_connpass_user_group_listC

Fetch Connpass user group information

Inputs: nickname (required).

get_connpass_user_listC

Fetch Connpass user information

Inputs: nickname (required).

get_connpass_user_presenter_eventsA

Fetch presenter events for a specific Connpass user

Inputs: nickname (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of Connpass user data: user info, user groups, user's events, and user's presenter events. The descriptions clearly differentiate the resource types, so an agent is unlikely to select the wrong tool.

    Naming Consistency4/5

    All tools follow the 'get_connpass_user_' prefix, but the resource nouns vary slightly in style ('list' vs 'group_list' vs 'events'). The pattern is consistent enough, though 'user_list' is a bit ambiguous compared to the other clearly resource-specific names.

    Tool Count5/5

    With only 4 tools, the server is well-scoped and focused on read-only Connpass user information. Each tool covers a distinct data need without unnecessary bloat, fitting comfortably within the ideal 3-15 range.

    Completeness4/5

    The server covers the core user-oriented resources: profile, groups, events, and presenter events. Minor gaps like attendee history or bookmarks could exist, but for a typical read-only user information server, this is a reasonable and functional surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables natural language search and retrieval of data from Japan's Ministry of Land, Infrastructure, Transport and Tourism (MLIT) Data Platform, including location-based queries, attribute filtering, and data visualization capabilities.
      18
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and retrieving IT study groups and event information from connpass.com, including user attended events, group events, and location-based event searches.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to securely query and analyze KARTE event data via BigQuery. It provides tools for fetching event logs, aggregating data, and exploring schemas using natural language.
      4
      -