内容
# MaxStat MCP
[](https://modelcontextprotocol.io/)
[](#工具列表)
[](CHANGELOG.md)
[](LICENSE)
[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.fbmdata%2Fmaxstat-mcp)
[](https://glama.ai/mcp/connectors/io.github.fbmdata/maxstat-mcp)
**MaxStat MCP 为 MAX messenger 的搜索、分析和监控提供服务**
开发者和运营商：**ООО «ФБМ Аналитикс» / FBM Analytics**
[Русский](#俄语) · [English](#英文)
[获取免费 API Token](https://maxstat.ru/dashboard/api) ·
[连接 MaxStat MCP](#快速开始) ·
[查看所有 21 个工具](#所有-21-个工具) ·
[AI 安装指南](llms-install.md)
> MaxStat 托管并维护 MCP 服务器。存储库中发布了清单、插件、分析技能、客户端配置和文档。MaxStat 的服务器实现和数据不是开源的。
## 俄语
### MaxStat MCP 可以提供什么
AI 代理连接到 MAX messenger 的实时索引，获取结构化数据，而不是搜索结果片段或手动收集的截图。
| 领域 | MCP 返回的数据 |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| 频道搜索 | 名称、描述、URL、类别、访问类型、受众范围和帖子数量、相关性、日期或受众排序 |
| 频道卡片 | ID、名称、描述、头像、URL、公共或私人访问、订阅者、帖子、类别、RKNA 日期和状态 |
| 受众动态 | 每日价值、最小值、最大值、绝对增长和百分比增长，选择时间范围 |
| 浏览量和反应 | 每篇帖子的总浏览量、平均值和最大值，以及每日历史 |
| 频道活动 | 帖子数量、每日历史以及按文本、照片、视频、文件和其他格式分布 |
| 帖子搜索 | 完整文本搜索，过滤器包括频道、格式、日期、浏览量和反应 |
| 帖子卡片 | 文本、URL、类型、附件、浏览量、反应数、日期和转发来源 |
| 发布历史 | 每日浏览量和反应历史 |
| 转发 | 发现的转发、它们的 URL、日期和目标频道 ID |
| 监控 | 频道的 webhook 或关键词和类别的新帖子 |
| 资费和消费 | 资费状态、期间、已包含、购买、已使用和剩余积分以及扣费历史 |
您还可以将公共或邀请频道的 MAX 添加到 MaxStat 的跟踪队列中。
### 已验证的索引规模
| 截至 2026 年 7 月 29 日验证 | 实时索引 |
| --------------------------- | -------------: |
| MAX 频道 | **408,501** |
| 帖子 | **86,315,758** |
| 频道类别 | **42** |
| MCP 工具 | **21** |
这些是 `maxstat.ru` 生产环境的指标，而不是 staging 环境。索引不断增长。使用 `search_channels`、`search_posts` 和 `get_categories` 获取最新的结果。
### 快速开始
1. 在 [MaxStat API 控制台](https://maxstat.ru/dashboard/api) 中创建令牌。
2. 不要在 Git 中公开或添加令牌。
3. 选择以下平台之一。
4. 重启客户端并检查是否有 21 个 MaxStat 工具。
| 参数 | 值 |
| -------------------- | ---------------------------- |
| 端点 | `https://maxstat.ru/api/mcp` |
| 传输 | Streamable HTTP |
| 授权 | API 令牌 |
| 头部 | `X-API-Token: <API_TOKEN>` |
| 环境变量 | `MAXSTAT_API_TOKEN` |
### 安装
#### Codex
在启动 Codex 之前，请在环境中保存令牌：
```bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"
```
添加市场并安装插件：
```bash
codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins
```
插件使用正确的 `X-API-Token` 用户头连接到 MCP。不要使用 Bearer 设置：它发送不同的头，不适用于 MaxStat。
直接安装：
```toml
[mcp_servers.maxstat]
url = "https://maxstat.ru/api/mcp"
env_http_headers = { "X-API-Token" = "MAXSTAT_API_TOKEN" }
```
#### Claude Code
```bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins
```
直接配置位于 [`configs/claude-code.json`](configs/claude-code.json)。
#### Visual Studio Code
在 `settings.json` 中添加市场：
```json
{
"chat.plugins.marketplaces": ["fbmdata/maxstat-mcp"]
}
```
打开扩展、搜索 `@agentPlugins`、选择 `MaxStat MCP` 并安装。对于直接连接，请复制 [`configs/vscode.json`](configs/vscode.json) 到 `.vscode/mcp.json`：VS Code 将安全地通过密码输入请求令牌。
#### GitHub Copilot CLI
```bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins
```
Claude Code、VS Code 和 GitHub Copilot CLI 使用相同的兼容插件、技能和 MCP 配置。
#### Gemini CLI
```bash
gemini extensions install https://github.com/fbmdata/maxstat-mcp
```
扩展程序将请求 `MAXSTAT_API_TOKEN` 作为敏感设置，并将其连接到 `X-API-Token` 头。Gemini 的说明位于 [`GEMINI.md`](GEMINI.md)。
#### Cursor
[](https://cursor.com/en/install-mcp?name=maxstat&config=eyJ1cmwiOiJodHRwczovL21heHN0YXQucnUvYXBpL21jcCIsImhlYWRlcnMiOnsiWC1BUEktVG9rZW4iOiIke2VudjpNQVhTVEFUX0FQSV9UT0tFTn0ifX0%3D)
在运行 Cursor 之前，请设置 `MAXSTAT_API_TOKEN`，然后单击上面的按钮。或者，将 [`configs/cursor.json`](configs/cursor.json) 与 `~/.cursor/mcp.json` 合并。
#### Cline
在运行 Cline 之前，请设置 `MAXSTAT_API_TOKEN`，并将代理传递给 [`llms-install.md`](llms-install.md)。该文件包含远程 Streamable HTTP 服务器的配置和连接检查。不需要本地 npm 包：MaxStat 在 `https://maxstat.ru/api/mcp` 上托管并维护服务器。
#### Windsurf
在运行 Windsurf 之前，请设置 `MAXSTAT_API_TOKEN`，并将 [`configs/windsurf.json`](configs/windsurf.json) 与 `~/.codeium/windsurf/mcp_config.json` 合并。配置使用本机 `${env:MAXSTAT_API_TOKEN}` 替换。
#### JetBrains AI Assistant
打开 **设置 → 工具 → AI Assistant → Model Context Protocol (MCP)**，添加 [`configs/jetbrains.json`](configs/jetbrains.json) 中的 HTTP 配置，并替换 `<API_TOKEN>` 在 IDE 中本地使用。JetBrains 尚未记录 MCP 头部中的环境变量替换，因此故意留空。
#### Claude Desktop
Claude 云自定义连接器不接受任意自定义 `X-API-Token`。在 OAuth 2.1 实施之前，请使用 [`configs/claude-desktop.json`](configs/claude-desktop.json) 中的本地桥接。需要 Node.js 和 npm；令牌仅保存在本地 Claude Desktop 配置中。
#### 通用配置
使用 [`configs/generic-mcp.json`](configs/generic-mcp.json)：
```json
{
"mcpServers": {
"maxstat": {
"type": "streamable-http",
"url": "https://maxstat.ru/api/mcp",
"headers": {
"X-API-Token": "<API_TOKEN>"
}
}
}
}
```
### 所有 21 个工具
#### 搜索和目录
| 工具 | 返回或执行 | 积分 |
| ----------------- | ---------------------------------------------------------------- | --------: |
| `get_categories` | 类别和每个类别的活跃频道数量 | 免费 |
| `search_channels` | 过滤、排序和分页的频道卡片 | 3 |
| `get_channel` | 单个频道的完整卡片 | 1 |
| `add_channel` | 将公共或邀请频道添加到队列 | 免费 |
| `search_posts` | 过滤、排序和分页的帖子 | 3 |
#### 频道分析
| 工具 | 返回 | 积分 |
| ------------------------- | ----------------------------------------------------------------- | ------: |
| `get_channel_subscribers` | 最小值、最大值、绝对增长和每日历史 | 5 |
| `get_channel_views` | 总浏览量、平均值、最大值和每日历史 | 5 |
| `get_channel_likes` | 总反应数、分类和每日历史 | 5 |
| `get_channel_posts` | 帖子数量、格式和活动历史 | 5 |
#### 帖子分析
| 工具 | 返回 | 积分 |
| ---------------- | ------------------------------------------------------------------ | ------: |
| `get_post` | 内容、附件、指标、转发源和发现的转发 | 1 |
| `get_post_views` | 当前浏览量和历史浏览量 | 5 |
| `get_post_likes` | 总反应数、分类和历史 | 5 |
#### Webhook 监控
| 工具 | 返回或执行 | 积分 |
| ----------------------------- | --------------------------------------------------------------- | --------------------------------: |
| `create_channel_subscription` | 频道的 webhook 回调 | 创建免费；每次交付 2 |
| `create_keyword_subscription` | 查询和类别的回调 | 创建免费；每次交付 3 |
| `get_subscriptions` | 带有状态和类型的订阅列表 | 免费 |
| `get_subscription` | 单个订阅、交付状态和最后错误 | 免费 |
| `update_subscription` | 更新回调 URL、暂停或恢复 | 免费 |
| `delete_subscription` | 删除 webhook 订阅 | 免费 |
Webhook 必须通过公共 HTTPS 地址可用。
#### 资费和使用情况
| 工具 | 返回 | 积分 |
| -------------------------- | ---------------------------------------------------------- | --------: |
| `get_account_subscription` | 资费、状态、期间和信用状态 | 免费 |
| `get_account_limits` | 已启用、购买、已用和剩余信用 | 免费 |
| `get_account_usage` | 按请求的历史信用支出 | 免费 |
### 真实数据示例
2026 年 7 月 29 日的生产环境验证请求返回：
- **MAX • 公告** 频道，拥有 3,496,789 名订阅者；
- 从 3,054,001 增长到 3,496,789，增长 **+442,788 / +14.5%**；
- [帖子](https://max.ru/max_news/AZ70lsF7P0s) 拥有 **17,888,688 次浏览** 和 **187,460 次反应**；
- 反应的分解、每日浏览和反应历史；
- 发现了 184 次转发。
值显示真实响应结构，不承诺固定产品指标。
### 查询示例
```text
查找 20 个具有最大订阅者增长的 MAX 科技频道。返回链接、当前受众和增长百分比。
```
```text
比较 5 个频道的受众、平均浏览量、反应、发布频率和格式分布。
```
```text
查找 7 月份有关抵押贷款的帖子。返回链接、文本、附件、浏览量、详细反应和发现的转发。
```
```text
为类别中的“人工智能”关键词设置 webhook。
```
```text
显示我的 MaxStat 资费、信用余额和过去 10 次扣费记录。
```
### 资费和安全
MCP 包含在所有 [MaxStat API 资费](https://maxstat.ru/promo/api) 中，无需额外费用。MCP 和直接 API 调用使用统一的信用余额。Test Drive 在第一次 API 请求时激活，并提供 1,000 个积分/30 天。
请勿在 issue、PR、配置、日志或截图中公开您的实际 API 令牌。有关漏洞的信息，请参阅 [`SECURITY.md`](SECURITY.md) 中的说明。
## 英文
MaxStat MCP 为 MAX messenger 提供 AI 代理结构化访问实时索引。支持频道和帖子发现、每日受众、浏览和反应历史、发布活动、附件和反应细节、转发检测、Webhook 监控和帐户信用使用情况。生产索引于 2026 年 7 月 29 日验证，共有 408,501 个频道、86,315,758 篇帖子、42 个频道类别和 21 个 MCP 工具。
### 连接
| 参数 | 值 |
| --------------- | ------------------------------------------------------------ |
| 端点 | `https://maxstat.ru/api/mcp` |
| 传输 | Streamable HTTP |
| 头部 | `X-API-Token: <API_TOKEN>` |
| 令牌控制台 | [maxstat.ru/dashboard/api](https://maxstat.ru/dashboard/api) |
### 安装
#### Codex
```bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"
codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins
```
#### Claude Code
```bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins
```
#### GitHub Copilot CLI
```bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins
```
#### Gemini CLI
```bash
gemini extensions install https://github.com/fbmdata/maxstat-mcp
```
VS Code、Cursor、Windsurf、JetBrains AI Assistant、Claude Desktop 和通用客户端，请使用已检查的 [`configs/`](configs/) 目录。俄语部分包含详细的客户端特定说明。
### 功能
- 搜索和筛选 MAX 频道和帖子。
- 检索频道配置文件、受众增长、浏览量、反应、活动和内容格式混合。
- 检索帖子文本、附件、指标、反应历史和发现的转发。
- 创建和管理频道或关键词的 webhook 订阅。
- 检查当前的 MaxStat 计划、信用余额和请求级使用情况。
完整的 21 项合约和信用成本请参阅 [所有 21 个工具](#所有-21-个工具)。
### 身份验证边界
此版本支持可以发送自定义 `X-API-Token` 标头的客户端。作为 ChatGPT 或 Claude 云连接器，请参阅单独的 OAuth 2.1 实现。
## 链接
- [MaxStat MCP](https://maxstat.ru/promo/mcp)
- [获取令牌](https://maxstat.ru/dashboard/api)
- [API 文档](https://maxstat.ru/api/docs)
- [API 资费](https://maxstat.ru/promo/api)
- [ООО «ФБМ Аналитикс»](https://fbmdata.ru)
- [MAX 上的 MaxStat Insights](https://max.ru/maxstat)
- [Telegram 上的 FBM API Insights](https://t.me/fbmapi)
## 许可证
MIT 仅适用于存储库中发布的清单、插件、技能、配置、文档和辅助检查。不适用于 MaxStat 服务、API、数据、数据库、商标和服务器实现。详细信息请参阅 [`NOTICE`](NOTICE)。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器