内容
🔌 Bitrix24 Stdio MCP 服务器
用于通过传入的 Webhook 与 Bitrix24 协作的 MCP 服务器。
它允许将 Bitrix24 连接到与 Stdio MCP 兼容的 AI 客户端，例如 Manus、Claude Desktop 等其他可以与模型上下文协议（Model Context Protocol）协作的工具。
服务器通过 Webhook URL 访问 Bitrix24 的 REST API，并以 AI 代理方便使用的格式提供数据。
## ⚙️ 功能
目前，服务器提供以下工具：
- **get_me** — 创建 Webhook 的用户配置文件（`profile`）。
get_task** — 根据 ID 获取一个或多个任务（每次调用10 个）。
- 示例参数：`{ "id": [9483, 9484] }`。
- **search_tasks** — 任务搜索。
- **search_groups** — 工作组和项目搜索。
- **get_group** — 根据 ID 获取一个或多个组/项目。
- 示例参数：`{ "ids": [286, 190] }`。
- **get_kanban_stages_by_group** — 获取一个或多个组的任务看板阶段。
- 示例参数：`{ "ids": [286, 190] }`。
- **get_task_comments** — 获取任务在新任务卡片中的评论（任务聊天）。
## 🚀 安装和启动
### 🧩 Manus / Claude Desktop / Cursor 配置示例
M示例：
```json
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": ["-y", "@x0333/bitrix24-mcp-server@latest"],
"env": {
"B24_BASE": "https://your-domain.bitrix24.ru/rest/USER_ID/WEBHOOK_CODE/"
}
}
}
}
```
之后，AI 客户端就可以调用服务器工具并从 Bitrix24 获取数据。
## 🔑 如何在 Bitrix24 中获取 Webhook URL
1. 打开您的 Bitrix24 门户。
2. 进入 **开发者** 部分（`https://your-bitrix-domain.com/devops/`）。
3. 点击 **其他** -> **传入 Webhook**。
4. 为 Webhook 授予必要的权限（具体权限取决于逻辑和安全性需求）。
5. 复制 **REST API 调用 URL**。
通常，该 URL 类：
```text
https://domain.bitrix24.ru/rest/1/abcdef12345/
```
此 URL 需要在添加 MCP 服务器时传递给 `B24_BASE` 变量。
## 🛠️ 开发
技术栈.js ≥ 20，TypeScript，[FastMCP](https.com/punkpeye/fastmcp)。
```bash
pnpm install
pnpm build # tsc → dist/
pnpm start # 需要 B24_BASE
pnpm typecheck
```
本地启动：
```bash
B24_BASE="https-domain.bitrix24.ru/rest/USEREBHOOK_CODE/" pnpm start
```
发布到 npm：通过 `.github/workflows/publish-n` 工作流在
