内容
# @theyahia/mango-office-mcp
MCP服务器，用于Mango Office API — 包括呼叫、用户、录音、短信和统计数据。**8个工具。**
[](https://www.npmjs.com/package/@theyahia/mango-office-mcp)
[](https://opensource.org/licenses/MIT)
这是 [Russian API MCP](https://github.com/theYahia/russian-mcp)（50个服务器）系列的一部分，由 [@theYahia](https://github.com/theYahia) 提供。
## 安装
### Claude Desktop
```json
{
"mcpServers": {
"mango-office": {
"command": "npx",
"args": ["-y", "@theyahia/mango-office-mcp"],
"env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" }
}
}
}
```
### Claude Code
```bash
claude mcp add mango-office -e MANGO_API_KEY=your-key -e MANGO_API_SALT=your-salt -- npx -y @theyahia/mango-office-mcp
```
### VS Code / Cursor
```json
{ "servers": { "mango-office": { "command": "npx", "args": ["-y", "@theyahia/mango-office-mcp"], "env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" } } } }
```
### Streamable HTTP
```bash
npx @theyahia/mango-office-mcp --http
# POST /mcp, GET /health — 端口 3000 (PORT=8080 可自定义)
```
> 需要 `MANGO_API_KEY` 和 `MANGO_API_SALT`。请在 [Mango Office](https://www.mango-office.ru) 个人账户中获取。
## 认证
所有请求都使用 HMAC-SHA256 签名：`sign = HMAC(apiKey + json + apiSalt)`。
基本 URL：`https://app.mango-office.ru/vpbx/`。
## 工具（6）
| 工具 | 描述 | API 端点 |
| --- | --- | --- |
| `get_calls` | 获取指定时间段的通话记录 | `stats/request` |
| `get_users` | 获取用户列表 | `config/users/request` |
| `make_call` | 发起外呼 | `commands/callback` |
| `get_stats` | 获取通话统计数据 | `stats/request` |
| `get_recording` | 获取通话录音链接 | `queries/recording/post` |
| `send_sms` | 发送短信 | `commands/sms` |
## 技能（2）
| 工具 | 描述 |
| --- | --- |
| `skill_call_history` | 今日通话记录 - 已生成报表 |
| `skill_stats` | 今日通话统计 - 汇总数据 |
## 示例
```
显示最近一小时的通话记录
Mango Office 用户列表
从 101 拨打到 +79001234567
今日通话统计数据
下载录音 rec_123
从 101 发送短信到 +79001234567 "请回电"
```
## Mango Office
[Mango Office](https://www.mango-office.ru/?utm_source=github&utm_medium=mcp) — 面向企业的云电话服务。
推荐计划：**最高 25% 终身返利** 于引荐客户的消费。
## 许可证
MIT
