What is Connpass User Mcp Server

connpass-user-mcp-server is a Model Context Protocol server that provides an API for accessing user information and event participation data from Connpass.

Use cases

Use cases include fetching user profiles for event organizers, displaying a user’s event history for personal dashboards, and generating reports on user participation in community events.

How to use

To use connpass-user-mcp-server, first obtain a Connpass API key. Set up the required environment variables by copying ‘.env.example’ to ‘.env’ and editing it to include your API key. Finally, start the server using the provided command in a suitable environment.

Key features

Key features include retrieving basic user information, group affiliations, events participated in, and events where the user is a presenter. Each feature allows querying by the user’s nickname.

Where to use

connpass-user-mcp-server can be used in applications that require integration with Connpass for user and event management, such as event planning tools, community platforms, and data analysis tools.

Connpass User MCP Server

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を設定

4. サーバーを起動します。

Denoでの起動（推奨）

Node.jsでの起動

1. MCPサーバーを起動するために必要な依存関係をインストールします。

npm ci

2. TypeScriptをビルドします。

npm run build

3. MCPクライアントの設定ファイル側にビルドしたファイルを指定します。

Dockerでの起動

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

1. Dockerイメージをビルドします。

docker build -t connpass-user-mcp-server .

2. コンテナを起動します。APIキーは環境変数として渡します。

docker run -e CONNPASS_API_KEY=XXXXXXXXXXXXXXXX connpass-user-mcp-server

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

npxでの起動（非推奨）

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

ただし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