使用说明
Connpass MCP服务器
用于通过“模型上下文协议”使用Connpass API的工具组。人工智能代理或LLM可以通过接近自然语言的输入获取Connpass事件组用户信息。
能做的事
- 事件搜索：按日期（YYYY-MM-DD格式）或关键字搜索事件
- 事件详细信息：指定事件ID以获得完整的说明文和发布信息
- 计划搜索：按日期显示用户计划参加的事件
- 获取用户信息：使用昵称或用户ID搜索用户信息
- 组信息获取：按关键字或地址搜索组
- 参与事件管理：取得特定用户的参加预定、过去参加、登台活动
- 発表情报取得：获取活动发布会话详细信息
- MCP Apps 対応：可显示交互式事件浏览器UI
MCP Apps 対応
支持MCP Apps扩展的客户端提供了丰富的交互式UI。
イベント検索結果を表示
スケジュール検索：タイトルクリックでConnpassへ直接移動
イベント詳細：セッション情報や主催者情報を確認
快速设置
以stdio模式启动（例如Claude Desktop）
# 起動
npx @kajidog/connpass-mcp-server
# API キーを指定
CONNPASS_API_KEY=your-api-key npx @kajidog/connpass-mcp-server
# ヘルプを表示
npx @kajidog/connpass-mcp-server --help
以HTTP模式启动
npx @kajidog/connpass-mcp-server --http --port 3000
必要要件
- Node.js 18 以上
- pnpm9以上（开发时）
- Docker & Docker Compose（Docker利用の场合）
用Docker启动
# .env ファイルを作成
cp .env.example .env
# .env ファイルを編集して CONNPASS_API_KEY を設定
# Docker Compose で起動
docker compose up -d
# ログを確認
docker compose logs -f
服务器是 http://localhost:3000/mcp 将条目添加到文档注册表。
目录配置
connpass-in-chatgpt/
├── apps/
│ └── mcp-server/ # MCP サーバー (MCP Apps Extension 版)
│ └── src/
│ ├── tools/ # MCP ツール定義 (events, users, groups)
│ │ ├── utils/ # ユーティリティ (formatting, shared, types)
│ │ └── ui-tools/ # UI 内部ツール
│ └── config.ts # サーバー設定
│
├── packages/
│ ├── api-client/ # Connpass API クライアント (TypeScript)
│ ├── connpass-ui/ # インタラクティブ UI コンポーネント (React)
│ └── mcp-core/ # MCP コア SDK (stdio/HTTP, config)
│
├── Dockerfile # Docker イメージ定義
├── docker-compose.yml # Docker Compose 設定
├── .env.example # 環境変数のサンプル
├── pnpm-workspace.yaml # pnpm ワークスペース設定
└── package.json # ルートパッケージ設定
环境变数
｜变量名｜说明｜默认｜
|--------|------|-----------|
| CONNPASS_API_KEY Connpass API密钥
| CONNPASS_DEFAULT_USER_ID 调度搜索的默认用户ID
| CONNPASS_RATE_LIMIT_ENABLED 启用API速率限制 true |
| CONNPASS_RATE_LIMIT_DELAY_MS 延迟速率限制（ms） 1000 |
| MCP_HTTP_MODE 以HTTP模式启动 false |
| MCP_HTTP_PORT HTTP模式的端口 3000 |
| MCP_HTTP_HOST HTTP模式的主机 0.0.0.0 |
| MCP_API_KEY ｜HTTP模式的API密钥认证｜-｜
开発
# 依存関係をインストール
pnpm install
# 全パッケージをビルド
pnpm build
# 型チェック
pnpm typecheck
# 開発モードで起動
pnpm dev
许可证
麻省理工学院
