codebuddy-matrix-channel
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MATRIX_E2EE | No | Whether to enable end-to-end encryption for Matrix rooms. | false |
| MATRIX_USER | No | Matrix username for password login. Alternative to MATRIX_ACCESS_TOKEN. | |
| MATRIX_USER_ID | No | Optional Matrix user ID used to identify the bot's own messages, e.g. @alice:matrix.org. | |
| MATRIX_OWNER_ID | Yes | Matrix user ID of the owner/manager. Only this identity can grant approvals. Required. | |
| MATRIX_PASSWORD | No | Matrix password for password login. Alternative to MATRIX_ACCESS_TOKEN. | |
| MATRIX_ALLOWLIST | Yes | Comma-separated sender user IDs allowed to send messages. Must be configured. | |
| MATRIX_CRYPTO_DB | No | Not effective in matrix-js-sdk 42.x; kept for compatibility. | |
| MATRIX_MEDIA_DIR | No | Directory for downloaded media. | .matrix-media |
| MATRIX_HOMESERVER | Yes | The Matrix homeserver URL, e.g. https://matrix.org (required). | |
| MATRIX_GATEWAY_URL | No | Full URL of the local CodeBuddy service, e.g. http://127.0.0.1:9099. Lower priority than MATRIX_GATEWAY_PORT. | |
| MATRIX_ACCESS_TOKEN | No | Account access token. Alternative to MATRIX_USER / MATRIX_PASSWORD. | |
| MATRIX_GATEWAY_PORT | No | Local CodeBuddy service port. Alternative to MATRIX_GATEWAY_URL. | 9099 |
| MATRIX_GATEWAY_DEBUG | No | Set to 1 to write raw Gateway SSE events to matrix-gateway-debug.log. | 0 |
| MATRIX_TRUSTED_ROOMS | No | Comma-separated trusted room IDs where all work is automatically executed. | |
| MATRIX_DOWNLOAD_MEDIA | No | Whether to download images/files and inject them as [file: path]. | false |
| MATRIX_ROOM_ALLOWLIST | No | Comma-separated room IDs allowed to be listened to. Leave empty to allow all. | |
| MATRIX_AUTHORIZED_WORK | No | Free text describing routinely authorized work, used to distinguish common vs unfamiliar requests. | |
| MATRIX_CONTROL_ROOM_ID | No | Matrix room ID for permission approval. Optional but required for the digital avatar mode. | |
| MATRIX_HIGH_RISK_TOOLS | No | Comma-separated high-risk tools that always require approval. | Bash,Write,Edit,MultiEdit,NotebookEdit |
| MATRIX_TRUSTED_SENDERS | No | Comma-separated trusted colleague user IDs whose work is automatically executed. | |
| MATRIX_GATEWAY_PASSWORD | No | Gateway password. Defaults to reading ~/.codebuddy/settings.json gateway.password. | |
| MATRIX_MENTION_REQUIRED | No | Whether to only respond to @mentions in group rooms. | true |
| MATRIX_STREAM_TIMEOUT_MS | No | Timeout in milliseconds for fetching Gateway run SSE replies. | 300000 |
| MATRIX_ROOM_CONTEXT_TURNS | No | Number of per-room context turns injected into the model context. 0 disables. | 6 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| experimental | {
"claude/channel": {},
"claude/channel/permission": {}
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| replyA | 通过 Matrix 把回复发送到指定房间(chat_id)。省略 chat_id 时回复发往最近一次转发进来的房间(原路返回)。发送会按配置自动重试;若多次仍发不回来源房间,则改用默认回复(MATRIX_DEFAULT_REPLY)发往控制室/owner 私聊兜底。 |
| health_checkA | 运行连接/E2EE 自检(等价于 npm run doctor),返回 Matrix 连接与加密状态。可在 /mcp 健康检查中调用。 |
| request_approvalA | 当判断当前任务来自陌生来源或含高风险时调用,把任务升级到管理者控制室等待审批。管理者回复 approve 后任务会被重放并执行。 |
| room_membersA | 获取指定 Matrix 房间(群聊)的在场成员列表,返回每个成员的 user_id 与 display_name,用于了解「谁在场」。chat_id 省略时取最近一次转发进来的房间。 |
| list_roomsA | 列出本分身已加入的所有 Matrix 房间(room_id + 标题),用于了解「我在哪些房间 / 群」。当不知道该回哪个房间时,可据此找到与管理者(owner)的私聊房间。 |
| room_infoA | 获取指定 Matrix 房间(群/私聊)的可读信息:名称、主题、成员昵称与 ID。用于配置与检查「房间 ID ↔ 名称」映射。chat_id 省略时取最近一次转发进来的房间。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/evlon/matrix-channel'
If you have feedback or need assistance with the MCP directory API, please join our Discord server