
Connpass User
Model Context Protocol server that provides connpass users API v2
GitHub Stats
Stars
3
Forks
2
Release Date
4/27/2025
about 2 months ago
Detailed Description
Connpassのユーザー情報や参加イベント情報等を取得するModel Context Protocol (MCP)サーバーです。
セットアップ
- (Connpass APIキーをすでに取得済の場合はスキップ)Connpass APIキーの発行をしてもらいます。詳細についてはconnpassのAPI利用についてを参照してください。
- このリポジトリをクローンします。
- 必要な環境変数を設定します。
.env.example
を.env
にコピーして、Connpass APIキーを設定します。
cp .env.example .env
# .envファイルを編集してCONNPASS_API_KEYを設定
- サーバーを起動します。
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での起動
- MCPサーバーを起動するために必要な依存関係をインストールします。
npm ci
- TypeScriptをビルドします。
npm run build
- 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を使用してサーバーを起動することもできます。
- Dockerイメージをビルドします。
docker build -t connpass-user-mcp-server .
- コンテナを起動します。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 OwnershipReceive Updates
Security Updates
Get notified about trust rating changes
to receive email notifications.