MCP Broker

MCP办公协作

提供方 Krittin-Khanueng

办公协作 未标注 会话登录 社区 / 第三方 ClaudeCursor

通过MCP协议实现AI代理间异步通信和协调的中间件服务,支持消息传递、频道管理和状态跟踪。

一句话选型结论

按资料字段整理

MCP Broker 属于办公协作类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 15 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量15暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

代理通信TypeScript本地部署消息队列任务协调AI协作分布式系统

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 15 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 15 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Broker当前 15 未标注 未标注 无 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Krittin-Khanueng上游标注的维护方 Krittin-Khanueng
分类办公协作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

30.7 KB
来自项目仓库与上游目录的原文,未做删改

mcp-broker

ระบบ broker สำหรับสื่อสารระหว่าง agent หลายตัว ทำงานผ่าน MCP server ช่วยให้ AI agent หลายตัว (เช่น Claude หลาย instance) ค้นหากัน ส่งข้อความ และประสานงานผ่าน channel ร่วมกัน — ข้อมูลทั้งหมดเก็บใน SQLite

สารบัญ

  • ทำไมต้อง mcp-broker? — เทียบกับ Agent/Subagent/Teams ของ Claude Code
  • หลักการทำงาน — ภาพรวมสถาปัตยกรรม
  • สิ่งที่ต้องติดตั้งก่อน — Bun, Claude Code
  • วิธีติดตั้ง — ติดตั้งแบบ plugin หรือ manual
  • วิธีใช้งาน — ลงทะเบียน, แชท, channel, broadcast, coordinator
  • ตัวอย่างการใช้งาน — 8 กรณีใช้งานจริง
  • Agent Profiles & Spawner — กำหนดโปรไฟล์ agent แล้ว spawn อัตโนมัติ
  • เครื่องมือ (Tools) — รายละเอียด 15 MCP tools
  • การตั้งค่า — ตัวแปร environment
  • ฟีเจอร์ Plugin — skills, coordinator agent, hooks
  • โครงสร้างโปรเจกต์ — ผังไฟล์
  • การพัฒนา — ตั้งค่า dev, ทดสอบ, สถาปัตยกรรม, เพิ่ม tool ใหม่
  • สัญญาอนุญาต

ทำไมต้อง mcp-broker?

Claude Code มี Agent tool, subagents, และ teams อยู่แล้ว — แล้วทำไมต้องมี broker อีก?

ปัญหา

ระบบ multi-agent ในตัวของ Claude Code มีข้อจำกัด:

  • Agent/Subagent — parent สร้าง child, child ทำงานเสร็จแล้วส่งผลกลับ จบ ไม่มีการสื่อสารต่อเนื่องระหว่าง agent
  • Teams (SendMessage) — agent คุยกันได้ แต่เป็นแบบ synchronous ไม่มีประวัติข้อความ ไม่มี channel ไม่มีการติดตามสถานะออนไลน์
  • ทุก session เป็นเกาะแยก — agent A ไม่รู้ว่า agent B มีอยู่ ถ้าไม่ได้ถูกสร้างจาก parent เดียวกัน

สิ่งที่ mcp-broker เพิ่มเติม

ความสามารถ Agent/Subagent Teams mcp-broker
ค้นหา agent (ใครออนไลน์อยู่?) - - ✓
ส่งข้อความแบบ async (ฝากไว้ อีกฝั่งมาอ่านทีหลัง) - - ✓
Channel (สื่อสารแบบกลุ่ม) - - ✓
ประวัติข้อความและการเก็บข้อมูลถาวร - - ✓
ส่งตาม role (ส่งถึง worker ทั้งหมด) - - ✓
Broadcast (ประกาศทุกคน) - ✓ ✓
สื่อสารข้าม session - - ✓
ติดตามสถานะออนไลน์ (heartbeat) - - ✓

เมื่อไหร่ใช้อะไร

  • ถ้าแค่ต้องการมอบหมายงานแล้วรอผล → ใช้ Agent/Subagent ของ Claude Code เลย
  • ถ้าต้องการ agent หลายตัวคุยกัน, ค้นหากัน, ส่งงานแบบ async, หรือเก็บประวัติข้อความ → ใช้ mcp-broker

หลักการทำงาน```

Agent A ──stdio──▶ ┌─────────────┐ ◀──stdio── Agent B
│ mcp-broker │
Agent C ──stdio──▶ │ (SQLite) │ ◀──stdio── Agent D
└─────────────┘


แต่ละ agent เชื่อมต่อผ่าน stdio และใช้ MCP tools เพื่อ:

1. **ลงทะเบียน** ตัวเองด้วยชื่อและ role
2. **ค้นหา** agent ที่ออนไลน์อยู่
3. **ส่งข้อความ** — แบบตรง, broadcast, ตาม role, หรือผ่าน channel
4. **รับข้อความ** ใหม่ (ใช้ cursor ไม่ซ้ำ)
5. **จัดการ channel** สำหรับสื่อสารตามหัวข้อ

## สิ่งที่ต้องติดตั้งก่อน

- **Bun** v1.0+ — runtime (รัน TypeScript ได้ตรง ไม่ต้อง build)
- **Claude Code** — CLI agent ของ Anthropic (ต้องรองรับระบบ plugin)```bash
# ติดตั้ง Bun (macOS / Linux)
curl -fsSL https://bun.sh/install | bash

# ตรวจสอบเวอร์ชัน
bun --version

วิธีติดตั้ง

แบบ Plugin (แนะนำ)```bash

เพิ่ม marketplace

/plugin marketplace add krittinkhaneung/mcp-broker

ติดตั้ง plugin

/plugin install broker


ได้ MCP server (15 tools), คำสั่ง slash, coordinator agent, และ hooks ทั้งหมด — ตั้งค่าให้อัตโนมัติ

### แบบ Manual```bash
# โคลนและติดตั้ง
git clone https://github.com/krittinkhaneung/mcp-broker.git
bun install

# เพิ่มเข้า Claude Code
claude mcp add --transport stdio broker -- bun /path/to/mcp-broker/src/index.ts

# รันทดสอบ
bun test

วิธีใช้งาน

พื้นฐาน: ลงทะเบียนและแชท

เปิด 2 Claude Code sessions ในเครื่องเดียวกัน:

Session A:```
> "ลงทะเบียนชื่อ 'alice' แล้วส่งข้อความถึง bob ว่า 'พร้อมเริ่มแล้ว'"

Claude เรียก: register(name: "alice", role: "peer")

Claude เรียก: send_message(to: "bob", content: "พร้อมเริ่มแล้ว")


**Session B:**```
> "ลงทะเบียนชื่อ 'bob' แล้วเช็คข้อความ"

# Claude เรียก: register(name: "bob", role: "peer")
# Claude เรียก: poll_messages()
# → ได้รับ: {from: "alice", content: "พร้อมเริ่มแล้ว"}

Channel: สื่อสารแบบกลุ่ม```

> "สร้าง channel #code-review สำหรับทีม"

Claude เรียก: create_channel(name: "#code-review", purpose: "รีวิว PR")

> "ส่งไปที่ #code-review: PR #42 ต้องการรีวิว"

Claude เรียก: send_message(to: "channel:#code-review", content: "PR #42 ต้องการรีวิว")


ทุก agent ที่ join channel จะเห็นข้อความเมื่อ poll

### Broadcast: ประกาศถึงทุกคน```
> "ประกาศทุก agent: จะ deploy ใน 5 นาที"
# Claude เรียก: send_message(to: "all", content: "จะ deploy ใน 5 นาที")

ทุก agent ที่ออนไลน์จะได้รับข้อความ

ส่งข้อความตาม Role```

> "ส่งถึง worker ทุกตัว: มีงานใหม่ใน #task-queue"

Claude เรียก: send_message(to: "role:worker", content: "มีงานใหม่ใน #task-queue")


เฉพาะ agent ที่ลงทะเบียนด้วย role `worker` เท่านั้นที่จะได้รับ

### Coordinator: ทำงานแบบขนาน

ใช้ `broker-coordinator` agent สำหรับงานที่ต้องกระจาย:```
> "ใช้ broker-coordinator รีวิว 3 ไฟล์นี้แบบขนาน:
src/auth.ts, src/api.ts, src/db.ts"

Coordinator จะ:
1. ลงทะเบียนตัวเองเป็น supervisor
2. สร้าง worker agents 3 ตัว
3. แจก 1 ไฟล์ให้แต่ละ worker รีวิว
4. รวมผลรีวิวกลับมาเป็นสรุป

Agent Profiles: spawn จากโปรไฟล์

กำหนด agent ไว้ล่วงหน้าใน profiles.yml แล้ว spawn ได้ทันที:```
> "ดูโปรไฟล์ที่มี"

Claude เรียก: list_profiles()

→ [{name: "reviewer", model: "sonnet", is_running: false},

{name: "tester", model: "haiku", is_running: false}]

> "spawn reviewer มารีวิว src/auth.ts"

Claude เรียก: spawn_agent(profile: "reviewer", task: "Review src/auth.ts for security issues")

→ {name: "reviewer", pid: 45678, status: "spawned"}

reviewer ลงทะเบียนอัตโนมัติ ทำงานแบบ non-interactive แล้วจบเอง

> "spawn tester มาเขียน test ให้ src/utils.ts"

Claude เรียก: spawn_agent(profile: "tester", task: "Write tests for src/utils.ts")

→ {name: "tester", pid: 45679, status: "spawned"}


ถ้าต้องการหยุด agent ก่อนทำเสร็จ:```
> "หยุด reviewer"
# Claude เรียก: stop_agent(name: "reviewer")
# → {name: "reviewer", stopped: true}

ค้นหา: ใครออนไลน์อยู่?```

> "แสดง agent ที่ออนไลน์ทั้งหมด"

Claude เรียก: list_peers()

→ [{name: "alice", role: "peer", status: "idle", online: true}, ...]

> "แสดงเฉพาะ worker"

Claude เรียก: list_peers(role: "worker")


`list_peers` ไม่ต้องลงทะเบียนก่อนก็ใช้ได้ — เหมาะสำหรับ monitoring

---

## ตัวอย่างการใช้งาน

### 1. รีวิวโค้ดแบบขนาน

**สถานการณ์:** มี PR ใหญ่ ต้องรีวิวหลายไฟล์```
> "ใช้ broker-coordinator รีวิว PR #123 แบ่งตาม directory:
- src/api/ (REST endpoints)
- src/services/ (business logic)
- src/models/ (data layer)"

Coordinator สร้าง worker 3 ตัว แต่ละตัวโฟกัสคนละ layer รวมผลกลับเป็นรีวิวรวม

2. งานระยะยาวข้าม Session

สถานการณ์: งานที่ใช้เวลานาน ต้องส่งต่อระหว่าง session

Session 1 (ผู้มอบหมาย):```
> "ลงทะเบียนชื่อ 'pipeline' แล้วโพสต์งานเหล่านี้ไปที่ #jobs:
1. ย้ายโครงสร้างฐานข้อมูล
2. อัปเดต API endpoints
3. เขียน integration tests"


**Session 2 (ผู้รับงาน — อาจเปิดทีหลัง):**```
> "ลงทะเบียนชื่อ 'worker-1' เข้าร่วม #jobs แล้วรับงานถัดไป"
# Worker poll #jobs เห็นงาน เริ่มทำ
# ทำเสร็จแล้วโพสต์ผลกลับไป #jobs

ข้อความเก็บใน SQLite — ไม่หายแม้ session เดิมจะปิดไปแล้ว

3. ประสานงานข้ามโปรเจกต์

สถานการณ์: ทำงาน 2 โปรเจกต์ที่เกี่ยวข้องกัน (เช่น frontend + backend)

Terminal 1 (~/frontend):```
> "ลงทะเบียนชื่อ 'frontend-dev'
ถ้า API contract เปลี่ยน ส่งข้อความบอก endpoint ใหม่ด้วย"


**Terminal 2 (`~/backend`):**```
> "ลงทะเบียนชื่อ 'backend-dev' เพิ่งเพิ่ม POST /api/tasks
ส่งถึง frontend-dev: 'endpoint ใหม่ POST /api/tasks
request body: {title: string, priority: number}'"

ทั้ง 2 โปรเจกต์ใช้ broker.db เดียวกัน — คุยกันข้ามโปรเจกต์ได้

4. รูปแบบ Supervisor + Workers

สถานการณ์: ต้องการ 1 agent คอย monitor และจัดการ worker หลายตัว```
> "ลงทะเบียนชื่อ 'supervisor' ด้วย role supervisor
สร้าง channel #status
คอย poll #status — ถ้า worker ไหนรายงาน 'failed' ให้มอบหมายงานใหม่"


Worker รายงานสถานะเข้า `#status`:```
> "ลงทะเบียนชื่อ 'worker-1' ด้วย role worker
เข้าร่วม #status โพสต์สถานะขณะทำงาน
ทำเสร็จแล้วส่งถึง supervisor: 'task-A เสร็จแล้ว'"

5. ระดมสมองหลายมุมมอง

สถานการณ์: ต้องการหลายมุมมองสำหรับตัดสินใจเรื่องการออกแบบ```
> "ใช้ broker-coordinator ระดมสมองเรื่องออกแบบฐานข้อมูล
สร้าง 3 agent ที่มีมุมมองต่างกัน:
- Agent 1: เน้นประสิทธิภาพการอ่าน
- Agent 2: เน้นปริมาณการเขียน
- Agent 3: เน้นความเรียบง่ายและดูแลง่าย
รวบรวมข้อเสนอทั้งหมดแล้วสังเคราะห์แนวทางที่ดีที่สุด"


### 6. รันชุดทดสอบหลายสภาพแวดล้อม

**สถานการณ์:** รันทดสอบหลาย environment พร้อมกัน```
> "ใช้ broker-coordinator รันชุดทดสอบในหลายการตั้งค่า:
- Node 20 + PostgreSQL 15
- Node 22 + PostgreSQL 16
- Bun + SQLite
รายงานว่าชุดค่าไหนผ่าน/ไม่ผ่าน"

7. Spawn agent จากโปรไฟล์ — รีวิว + ทดสอบอัตโนมัติ

สถานการณ์: มีโปรไฟล์ reviewer และ tester ตั้งไว้แล้ว อยาก spawn ทั้งคู่ทำงานพร้อมกัน```
> "ลงทะเบียนชื่อ 'lead' เป็น supervisor
spawn reviewer มารีวิว src/api/ ทั้ง directory
spawn tester มาเขียน test ให้ src/services/"

Claude เรียก: register(name: "lead", role: "supervisor")

Claude เรียก: spawn_agent(profile: "reviewer", task: "Review all files in src/api/")

Claude เรียก: spawn_agent(profile: "tester", task: "Write tests for src/services/")

reviewer และ tester ลงทะเบียนอัตโนมัติ ทำงานแบบ non-interactive

lead สามารถ poll_messages() เพื่อดูผลเมื่อเสร็จ

ถ้า agent ไหน crash จะได้รับ DM แจ้งอัตโนมัติ


### 8. Spawn agent ตาม role เฉพาะทาง

**สถานการณ์:** ตั้งโปรไฟล์หลายตัวไว้ใช้ตามงาน — security audit, performance check, docs writer```yaml
# profiles.yml
profiles:
security-auditor:
system_prompt: |
You are a security specialist.
Scan for vulnerabilities: injection, XSS, auth bypass, secrets in code.
model: opus
max_budget_usd: 3.00
allowed_tools: [Read, Grep, Glob, Bash]
role: worker

docs-writer:
system_prompt: |
You are a technical writer.
Write clear, concise documentation for the given code.
model: haiku
max_budget_usd: 1.00
allowed_tools: [Read, Write, Edit, Grep, Glob]
role: worker
``````
> "spawn security-auditor มาตรวจ src/auth/ ทั้งหมด"
# Claude เรียก: spawn_agent(profile: "security-auditor", task: "Full security audit of src/auth/")

> "spawn docs-writer มาเขียน docs ให้ src/api/"
# Claude เรียก: spawn_agent(profile: "docs-writer", task: "Write API documentation for src/api/")

ใช้ list_profiles() เพื่อดูว่า agent ไหนกำลังทำงานอยู่ และ stop_agent() เพื่อหยุดก่อนเวลา


Agent Profiles & Spawner

กำหนดโปรไฟล์ agent ไว้ล่วงหน้าใน YAML แล้วให้ broker spawn Claude Code instance ให้อัตโนมัติ — ไม่ต้องเขียน prompt เองทุกครั้ง

ตั้งค่าโปรไฟล์

สร้างไฟล์ ~/.claude/mcp-broker/profiles.yml (ดูตัวอย่างใน profiles.example.yml):```yaml
profiles:
reviewer:
system_prompt: |
You are an expert code reviewer.
Check for code quality, security, and performance.
model: sonnet
max_budget_usd: 1.00
allowed_tools:
- Read
- Grep
- Glob
- Bash
additional_instructions: |

Review Guidelines

  • Check OWASP Top 10
  • Report only, do not modify code
    role: worker
    permission_mode: auto

tester:
system_prompt: |
You are a test engineer.
Write comprehensive tests covering edge cases.
model: haiku
max_budget_usd: 2.00
allowed_tools:
- Read
- Write
- Edit
- Bash
role: worker


### ฟิลด์โปรไฟล์

| ฟิลด์ | ต้องระบุ | คำอธิบาย |
|-------|:---:|---------|
| `system_prompt` | ✓ | คำสั่งหลักของ agent |
| `model` | ✓ | `opus`, `sonnet`, หรือ `haiku` |
| `max_budget_usd` | | งบประมาณสูงสุด (ดอลลาร์) |
| `auto_register` | | ลงทะเบียนกับ broker อัตโนมัติ (ค่าเริ่มต้น: `true`) |
| `allowed_tools` | | จำกัด built-in tools (MCP tools ใช้ได้เสมอ) |
| `additional_instructions` | | คำสั่งเพิ่มเติม |
| `role` | | `peer`, `worker`, `supervisor` (ค่าเริ่มต้น: `worker`) |
| `working_directory` | | directory ที่ agent ทำงาน |
| `permission_mode` | | `default`, `auto`, `bypassPermissions` (ค่าเริ่มต้น: `auto`) |

### วิธีใช้```
> "ดูโปรไฟล์ที่มีทั้งหมด"
# Claude เรียก: list_profiles()
# → [{name: "reviewer", model: "sonnet", is_running: false}, ...]

> "spawn reviewer มารีวิวไฟล์ src/auth.ts"
# Claude เรียก: spawn_agent(profile: "reviewer", task: "Review src/auth.ts")
# → {name: "reviewer", pid: 12345, status: "spawned"}

> "หยุด reviewer"
# Claude เรียก: stop_agent(name: "reviewer")
# → {name: "reviewer", stopped: true}

คุณสมบัติ

  • Singleton — 1 โปรไฟล์ = 1 instance (ป้องกัน spawn ซ้ำ)
  • Auto-register — agent ลงทะเบียนกับ broker อัตโนมัติ สื่อสารผ่าน message ได้ทันที
  • Crash detection — ถ้า agent crash จะแจ้ง coordinator ผ่าน DM อัตโนมัติ
  • Graceful shutdown — SIGTERM → รอ 10 วิ → SIGKILL
  • Cleanup — ปิด broker แล้ว agent ทั้งหมดถูก cleanup อัตโนมัติ

เครื่องมือ (Tools)

ลงทะเบียนและติดตามสถานะ

เครื่องมือ คำอธิบาย
register ลงทะเบียน agent ด้วย name, role (supervisor/worker/peer), และ metadata
heartbeat อัปเดตสถานะออนไลน์ เปลี่ยน status (idle/busy/blocked) ได้ ส่งคืนจำนวน peer ที่ออนไลน์
unregister ยกเลิกการลงทะเบียน agent ปัจจุบัน

ส่งข้อความ

เครื่องมือ คำอธิบาย
send_message ส่งถึงชื่อ agent (DM), "all" (broadcast), "role:" (ตาม role), หรือ "channel:#name" (ผ่าน channel)
poll_messages ดึงข้อความใหม่จากทุกแหล่ง หรือกรองเฉพาะ channel ใช้ cursor ไม่ซ้ำ

Channel

เครื่องมือ คำอธิบาย
create_channel สร้าง channel (ชื่อต้องขึ้นต้นด้วย #) พร้อมวัตถุประสงค์
join_channel เข้าร่วม channel
leave_channel ออกจาก channel
list_channels แสดง channel ทั้งหมดพร้อมจำนวนสมาชิก

ค้นหาและประวัติ

เครื่องมือ คำอธิบาย
list_peers แสดง agent ทั้งหมดพร้อมสถานะออนไลน์ กรองตาม role ได้ ใช้ได้โดยไม่ต้องลงทะเบียน
get_history ค้นหาประวัติข้อความ กรองตาม peer, channel, ลำดับ, และจำนวน
purge_history ลบข้อความที่เก่ากว่าวันที่กำหนด (ISO 8601)

โปรไฟล์และ Spawner

เครื่องมือ คำอธิบาย
spawn_agent Spawn Claude Code instance จากโปรไฟล์ที่กำหนดไว้ใน profiles.yml
stop_agent หยุด agent ที่ spawn มา (SIGTERM → SIGKILL)
list_profiles แสดงโปรไฟล์ทั้งหมดพร้อมสถานะว่ากำลังทำงานอยู่หรือไม่

การตั้งค่า

ตั้งค่าทั้งหมดผ่านตัวแปร environment:

ตัวแปร ค่าเริ่มต้น คำอธิบาย
BROKER_DB_PATH ~/.claude/mcp-broker/broker.db ตำแหน่งไฟล์ฐานข้อมูล SQLite
BROKER_HEARTBEAT_TTL 60000 มิลลิวินาทีก่อนถือว่า agent ออฟไลน์
BROKER_MAX_MESSAGE_LENGTH 10000 ความยาวเนื้อหาข้อความสูงสุด (ตัวอักษร)
BROKER_PRUNE_AFTER_DAYS 7 ลบ agent ที่ไม่ใช้งานอัตโนมัติหลังจำนวนวันนี้
BROKER_MAX_AGENTS 100 จำนวน agent สูงสุดที่ลงทะเบียนได้
BROKER_MAX_CHANNELS 50 จำนวน channel สูงสุด
BROKER_PROFILES_PATH ~/.claude/mcp-broker/profiles.yml ตำแหน่งไฟล์โปรไฟล์ agent

ฟีเจอร์ Plugin

คำสั่ง Slash

คำสั่ง คำอธิบาย
/broker:status แดชบอร์ด — agent ที่ออนไลน์, channel, สถิติข้อความ
/broker:reset ล้างข้อความเก่า, ตัด agent ที่หมดอายุ, หรือรีเซ็ตทั้งหมด
/broker:setup ตรวจสอบสุขภาพระบบและคู่มือเริ่มต้นใช้งาน

Coordinator Agent

ใช้ broker-coordinator สำหรับประสานงานหลาย agent:
- กระจายงานให้ worker agent หลายตัวทำพร้อมกัน
- คิวงานพร้อมลองใหม่อัตโนมัติเมื่อล้มเหลว
- ติดตามความคืบหน้าและรวบรวมผลลัพธ์

Session Hooks

  • เริ่ม Session — ลงทะเบียน agent อัตโนมัติเมื่อเปิด session
  • จบ Session — ยกเลิกการลงทะเบียนอัตโนมัติเมื่อปิด

โครงสร้างโปรเจกต์```

.claude-plugin/
plugin.json ไฟล์ manifest ของ plugin
marketplace.json รายการสำหรับ GitHub marketplace
.mcp.json การตั้งค่า MCP server (ตั้งค่าอัตโนมัติโดย plugin)
skills/
status/SKILL.md /broker:status
reset/SKILL.md /broker:reset
setup/SKILL.md /broker:setup
agents/
broker-coordinator.md agent ประสานงานหลายตัว
hooks/
hooks.json ลงทะเบียนอัตโนมัติเมื่อเริ่ม/จบ session
profiles.example.yml ตัวอย่างไฟล์โปรไฟล์ agent
src/
index.ts จุดเริ่มต้น MCP server — ลงทะเบียน 15 tools
config.ts การตั้งค่าจาก environment พร้อมค่าเริ่มต้น
errors.ts คลาส BrokerError สำหรับจัดการ error
db.ts สร้างโครงสร้าง SQLite (WAL mode, foreign keys, migration)
state.ts สถานะ session ในหน่วยความจำ (agent ปัจจุบัน + spawned processes)
presence.ts heartbeat, ตรวจสอบออนไลน์, ตัด agent หมดอายุ
types.ts interface หลัก (Agent, Channel, Message, Profile, SpawnedProcess)
validators.ts ตรวจสอบข้อมูลนำเข้า (ชื่อ, channel, role, เนื้อหา)
profiles.ts โหลดและตรวจสอบโปรไฟล์ agent จาก YAML
spawner.ts spawn/stop Claude CLI, จัดการ process, MCP config generation
tools/
register.ts register, heartbeat, unregister
messaging.ts send_message, poll_messages
channels.ts create_channel, join_channel, leave_channel, list_channels
peers.ts list_peers
history.ts get_history, purge_history
spawn.ts spawn_agent, stop_agent, list_profiles
tests/
helpers.ts เครื่องมือทดสอบ SQLite ในหน่วยความจำ
*.test.ts ทดสอบครบทุกโมดูล


## การพัฒนา

### สิ่งที่ต้องมี

- Bun v1.0+
- Git

### ตั้งค่า```bash
git clone https://github.com/krittinkhaneung/mcp-broker.git
cd mcp-broker
bun install

คำสั่งที่ใช้บ่อย```bash

bun test # รันทดสอบทั้งหมด (SQLite ในหน่วยความจำ)
bun test --watch # รันทดสอบแบบ watch mode
bun run build # คอมไพล์ TypeScript ไปที่ dist/
bun run dev # คอมไพล์แบบ --watch
bun src/index.ts # เริ่ม MCP server ตรง (stdio)


### การรันทดสอบ

ใช้ SQLite ในหน่วยความจำ — ไม่ต้องตั้งค่าฐานข้อมูล:```bash
$ bun test
bun test v1.x.x

✓ tests/db.test.ts
✓ tests/register.test.ts
✓ tests/messaging.test.ts
✓ tests/channels.test.ts
✓ tests/peers.test.ts
✓ tests/history.test.ts
✓ tests/wrapHandler.test.ts

เพิ่ม Tool ใหม่

  1. สร้าง handler ใน src/tools/ (ดูตัวอย่างจาก peers.ts)
  2. เพิ่มไฟล์ทดสอบใน tests/
  3. ลงทะเบียน tool ใน src/index.ts ด้วย server.registerTool()
  4. อัปเดตตาราง tools ใน README

สถาปัตยกรรมโปรเจกต์```

MCP Client (Claude) ──stdio──▶ index.ts (MCP Server)
│
├─ tools/register.ts ──▶ state.ts (สถานะ session)
├─ tools/messaging.ts ──▶ presence.ts (heartbeat)
├─ tools/channels.ts ──▶ validators.ts (ตรวจสอบข้อมูล)
├─ tools/peers.ts ──▶ errors.ts (BrokerError)
├─ tools/history.ts ──▶ db.ts (SQLite)
└─ tools/spawn.ts ──▶ profiles.ts (YAML config)
│ ──▶ spawner.ts (process mgmt)
│ │
▼ ▼
claude CLI ◀──────── profiles.yml
(spawned) │
▼
broker.db
```

เทคโนโลยีที่ใช้

ส่วนประกอบ เทคโนโลยี
Runtime Bun — รัน TypeScript ได้ตรง ไม่ต้อง build
ฐานข้อมูล bun:sqlite — SQLite ในตัว พร้อม WAL mode
MCP Framework @modelcontextprotocol/sdk — stdio transport
ตรวจสอบข้อมูล Zod — ตรวจสอบ schema
ทดสอบ bun:test — ตัวรันทดสอบในตัว พร้อม SQLite ในหน่วยความจำ

Dependencies

Runtime:
- @modelcontextprotocol/sdk — MCP server framework
- uuid — สร้าง ID ที่ไม่ซ้ำ
- zod — ตรวจสอบ schema
- yaml — อ่านไฟล์โปรไฟล์ agent

Dev:
- typescript — ตรวจสอบ type และคอมไพล์
- bun-types — type definitions สำหรับ Bun API
- @types/uuid — type definitions สำหรับ UUID

สัญญาอนุญาต

MIT

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Broker 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Broker 怎么在 Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Broker 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Broker 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

MCP Broker 支持哪些客户端?

资料标注支持 Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Broker 能提供哪些能力?

资料显示约 15 个工具;能力标签包括 分布式系统、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。