Connpass User MCP Server

🚀 ConnpassユーザーMCPサーバー

このサーバーは、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を使用して起動（推奨）

"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

2. TypeScriptファイルをビルドします。

npm run build

3. MCPクライアントの設定ファイルで、ビルド後のファイルを指定します。

"connpass-user-mcp-server": {
  "command": "wsl.exe",
  "args": [
    "/home/user/.local/share/mise/installs/node/20240116-5f97b4-linux-x64/bin/node",
    "/home/user/connpass-mcp-server/out/index.js"
  ]
}

Dockerを使用して起動

プロジェクトをDockerfileに追加し、ビルドします。

# Dockerfileの内容は以下のように仮定します。
FROM node:20

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD ["node", "out/index.js"]

その後、イメージをビルドし、コンテナを実行します。

docker build -t connpass-mcp-server .
docker run --env-file .env connpass-mcp-server

✨ 主な機能

ユーザー情報の取得

• /api/users: すべてのユーザーの詳細情報を返します。
• /api/users/${username}: 指定されたユーザー名の詳細情報を返します。

ユーザーイベントの取得

• /api/users/${username}/events: 指定されたユーザーが参加したすべてのイベントを返します。
• /api/users/${username}/presentations: 指定されたユーザーが講演者として参加したイベントを返します。

💻 使用例

基本的な使用法

以下のようなプロンプトをLLMに渡すことができます。

# "yamanoku, 請告诉我 okuto_oyama 的 Connpass 用户信息。"
"yamanoku, okuto_oyamaのConnpassユーザー情報を教えてください。"

# "yamanoku, 请分享你参加的 Connpass 活动信息。"
"yamanoku, あなたが参加したConnpassイベントの情報を共有してください。"

# "yamanoku, 请列出你作为演讲者参与的 Connpass 活动。"
"yamanoku, あなたが講演者として参加したConnpassイベントをリストアップしてください。"

# "yamanoku, 请显示你的 Connpass 所属小组列表。"
"yamanoku, あなたのConnpass所属グループのリストを表示してください。"

🔧 技術詳細

テスト

Denoを使用したテスト

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

deno task test

謝辞

このプロジェクトのロゴを制作してくれたGPT - 4o Image Generation、および実装過程での支援とドキュメント例を提供してくれたClaude 3.7 Sonnetに感謝します。

📄 ライセンス

MIT License