groupsio

groupsio-mcp-server

Groups.io REST API を介して Groups.io のデータを利用・管理するための MCP サーバーです。

前提条件

• Node.js 18+
• Groups.io API キー（https://groups.io/settings/apikeys で取得できます）

インストール

git clone https://github.com/ke4qqq/groupsio-mcp-server.git
cd groupsio-mcp-server
npm install

設定

MCP クライアントの設定にサーバーを追加します。設定ファイルはクライアントによって異なります。

クライアント	設定ファイル
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
Kiro	~/.kiro/settings/mcp.json
VS Code（Copilot）	ワークスペース内の .vscode/mcp.json

設定ファイルの mcpServers オブジェクトに次のエントリを追加します。

{
  "mcpServers": {
    "groupsio": {
      "command": "node",
      "args": ["/path/to/groupsio-mcp-server/index.js"],
      "env": {
        "GROUPSIO_API_KEY": "your_key_here"
      }
    }
  }
}

依存関係

パッケージ	バージョン	ライセンス	用途
@modelcontextprotocol/sdk	^1.29.0	MIT	MCP サーバーのフレームワークと stdio トランスポート
zod	^4.3.6	MIT	入力スキーマの検証

ツール

ツール	説明
list_subscriptions	購読しているすべてのグループを一覧表示します
get_group	ID または名前でグループ設定を取得します
get_subgroups	親グループのサブグループを取得します
get_subgroups_by_category	カテゴリー別に整理されたサブグループを取得します
get_topics	グループ内のメッセージスレッドを取得します
get_topic	特定のトピック内のメッセージを取得します
get_message	番号で単一のメッセージを取得します
get_messages	グループ内のメッセージを取得します
search_archives	メッセージアーカイブを検索します
get_members	グループのメンバーを取得します
get_member_directory	公開メンバー名簿を取得します
search_members	メールアドレスまたは名前でメンバーを検索します
get_hashtags	グループ内のハッシュタグを取得します
get_message_history	月ごとのメッセージ数の履歴を取得します
get_permissions	グループ内での自分の権限を取得します
get_events	今後のイベントを取得します
get_files	グループ内のファイルを取得します
get_wiki_pages	グループ内の Wiki ページを取得します
get_databases	グループ内のデータベースを取得します
update_subscription	購読設定（メール配信、メッセージの選択など）を更新します
delete_subscription	グループの購読を解除します

ライセンス

このプロジェクトは MIT-0 ライセンスの下で公開されています。

謝辞

Kiro の支援を受けて作成されました。