Connpass User MCP Server

🚀 Connpass 用戶 MCP 服務器

這是一個用於獲取 Connpass 用戶信息、參加活動信息等的 Model Context Protocol (MCP) 服務器。藉助該服務器，你可以輕鬆地從 Connpass 平臺獲取所需的用戶和活動數據。

🚀 快速開始

Connpass 用戶 MCP 服務器能幫助你從 Connpass 平臺獲取用戶和活動信息。以下是啟動服務器的詳細步驟。

📦 安裝指南

準備工作

1. （如果您已經擁有 Connpass API 密鑰，請跳過）請申請一個 Connpass API 密鑰。有關詳細信息，請參閱 connpass 的 API 使用指南。
2. 克隆此倉庫。
3. 配置必要的環境變量。將 .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 啟動

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，請分享你參加的 Connpass 活動信息。”
• “yamanoku，請列出你作為演講者參與的 Connpass 活動。”
• “yamanoku，請顯示你的 Connpass 所屬小組列表。”

🔧 技術細節

測試

使用 Deno 進行測試

運行 Connpass API 的集成測試：

deno task test

📄 許可證

MIT License

🙏 致謝

感謝 GPT - 4o Image Generation 為該項目製作的徽標，以及 Claude 3.7 Sonnet 在實現過程中提供的幫助和文檔示例。