Grovs

用于在 Grovs 上管理深度链接、分析数据和应用配置的 MCP 服务。
可与 Claude Code、Cursor、Windsurf 及任何兼容 MCP 的客户端配合使用。

网站 · 文档 · 问题反馈

---

什么是 Grovs？

Grovs 是一个开源、注重隐私的移动应用增长平台，可自托管，是 Branch.io 和 AppsFlyer 的替代方案。它提供：

• 深度链接 — 通过一个链接，将用户引导至 iOS、Android 和 Web 上的正确内容。延迟深度链接在安装过程中仍然有效，确保用户首次打开应用时进入正确页面。
• 归因 — 确定性的第一方安装和事件归因。不使用指纹识别，也不与广告网络共享数据。
• 收入分析 — 将应用内购买、订阅和自定义收入事件关联回促成安装的广告活动。
• 广告活动 — 将链接分组、跟踪效果，并比较不同渠道的结果。

托管于欧盟，提供开源 SDK，生产环境中每日活跃用户超过 2,000 万。有关自托管，请参阅后端仓库。

什么是这个 MCP 服务？

这是一个 MCP（模型上下文协议）服务，可让 AI 助手通过自然语言管理你的 Grovs 平台。创建深度链接、查看分析数据、配置重定向、运行广告活动——无需离开编辑器。

快速开始

Claude Code

/plugin marketplace add grovs-io/mcp
/plugin install grovs@grovs

安装 MCP 服务和用于教会 Claude 如何使用 Grovs 的技能。首次使用时会打开浏览器进行 OAuth 身份验证——无需 API 密钥。

Cursor

打开 Settings > MCP，添加新服务：

{
  "mcpServers": {
    "grovs": {
      "url": "https://mcp.grovs.io/mcp"
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "grovs": {
      "serverUrl": "https://mcp.grovs.io/mcp"
    }
  }
}

VS Code（GitHub Copilot）

添加到 .vscode/mcp.json：

{
  "servers": {
    "grovs": {
      "type": "http",
      "url": "https://mcp.grovs.io/mcp"
    }
  }
}

ChatGPT Desktop

打开 Settings > MCP Servers > Add Server 并输入：

https://mcp.grovs.io/mcp

自托管

如果你运行自己的 Grovs 后端，请在本地运行 MCP 服务，并将客户端指向该服务：

git clone https://github.com/grovs-io/mcp.git
cd mcp
npm install && npm run build
npm start

也可以使用 Docker：

docker build -t grovs-mcp .
docker run -p 8080:8080 grovs-mcp

然后在上述任一客户端配置中，将 http://localhost:8080/mcp 用作服务 URL。

所有客户端首次使用时都会触发 OAuth 流程——浏览器窗口将打开，以便通过你的 Grovs 账户进行身份验证。

配置

变量	默认值	描述
PORT	8080	服务端口
GROVS_API_URL	https://mcp.grovs.io	Grovs 后端 URL（自托管时可覆盖）
PUBLIC_URL	http://localhost:8080	此 MCP 服务的公共 URL（用于 OAuth 回调）

本地开发时，将 .env.example 复制为 .env。

工具

工具	描述
get_status	账户信息、实例、项目和域名
get_usage	实例的使用指标和订阅状态
create_project	创建包含生产和测试项目的新实例
create_link	创建包含元数据、标签和自定义数据的深度链接
get_link	按路径获取链接的完整详情
update_link	更新链接的元数据、标签或重定向
archive_link	停用链接（不可逆）
search_links	使用分页和筛选条件搜索并列出链接
get_analytics_overview	项目级指标：浏览量、安装量、打开量、收入
get_link_analytics	每个链接的每日指标
get_top_links	按浏览量排名的表现最佳链接
create_campaign	创建用于归类相关链接的营销活动
list_campaigns	列出营销活动及汇总指标
archive_campaign	归档营销活动并停用其链接
configure_redirects	设置各平台的重定向行为（App Store、Play Store、网页）
configure_sdk	配置 iOS/Android SDK 设置（Bundle ID、Team ID 等）

架构

MCP Client (Claude Code, Cursor, etc.)
    │
    │  MCP protocol over HTTP
    ▼
Express app (src/app.ts)
    │
    ├── OAuth flow (/authorize, /callback, /register)
    │
    └── MCP endpoint (/mcp)
            │
            ├── Tool registration (src/server.ts)
            │       Zod schema validation + runWithAuth error boundary
            │
            ├── Handlers (src/tools/handlers.ts)
            │       Business logic, plain functions, throw on error
            │
            ├── Formatters (src/tools/formatters.ts)
            │       Convert API JSON to human-readable text
            │
            └── API client (src/api-client.ts)
                    HTTP calls to Grovs backend

开发

npm run dev          # start with auto-reload
npm run build        # compile TypeScript
npm test             # run tests (186 tests)
npm run test:watch   # run tests in watch mode
npm run lint         # ESLint
npm run format       # Prettier

有关项目结构和 PR 指南，请参阅 CONTRIBUTING.md。

SDK

平台	仓库
iOS	grovs-io/grovs-ios
Android	grovs-io/grovs-android
React Native	grovs-io/grovs-react-native
Flutter	grovs-io/grovs-flutter

许可证

MIT