mcpField
G
groupsio

groupsio

本地服务
github.com/ke4qqq通信协作129 周前更新
代码仓库

关于 groupsio

groupsio 是通过 Groups.io REST API 读取和管理 Groups.io 数据的 MCP 服务，面向需要在 MCP 客户端中处理群组内容的用户。它涵盖消息、成员、文件和订阅设置等多类数据。

主要功能

  1. 01查看群组、子群组与订阅
  2. 02读取主题、消息及历史记录
  3. 03搜索消息存档和群组成员
  4. 04查看活动、文件、维基与数据库
  5. 05更改订阅设置或退订

适用场景

  1. 01检索群组中的旧消息
  2. 02查看群组成员和公开目录
  3. 03管理邮件投递等订阅选项

MCP 相关

它通过 Groups.io REST API 提供 MCP 工具，供 MCP 客户端读取群组信息并管理订阅。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ke4qqq-groupsio": {
      "command": "npx",
      "args": [
        "-y",
        "@ke4qqq/groupsio-mcp-server"
      ],
      "env": {
        "GROUPSIO_API_KEY": "<GROUPSIO_API_KEY>"
      }
    }
  }
}
启动命令npx -y @ke4qqq/groupsio-mcp-server
需要配置的环境变量
GROUPSIO_API_KEY密钥Groups.io API key from https://groups.io/settings/apikeys

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@ke4qqq/groupsio-mcp-server1.0.0

工具

21

收录的工具列表 · 更新于 2 周前

参数类型必填说明
limitnumber否最大结果数（1–100，默认值为 10）
page_tokenstring否分页令牌

详细介绍

groupsio-mcp-server

通过 Groups.io REST API 使用和管理 Groups.io 数据的 MCP 服务。

前提条件

安装

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.0MITMCP 服务框架和标准输入/输出传输
zod^4.3.6MIT输入架构验证

工具

工具描述
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 的帮助下编写。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。