使用说明
mcp服务器矩阵
A. 模型上下文协议（MCP） 服务器 矩阵 --开放、分散的通信协议。
建于 矩阵nio，此服务器允许任何兼容MCP的AI助手（Claude、OpenClaw等）发送和读取消息、管理房间，并与任何Matrix主服务器（Synapse、Dendrite、Conduit）交互。
特性
| 工具 | 说明 |
|---|---|
send_message |
发送带有可选回复的消息（文本、HTML或Markdown） |
read_messages |
读取最近的消息（带分页） |
get_messages_by_date |
获取按日期范围筛选的邮件 |
list_rooms |
列出所有已加入的房间 |
get_room_info |
房间详细信息——名称、主题、成员、加密状态 |
get_room_members |
使用显示名称和头像列出已加入的成员 |
get_notification_counts |
每间客房的未读和提及次数 |
get_direct_messages |
列出未读状态的DM对话 |
send_direct_message |
发送DM（必要时自动创建房间） |
get_user_profile |
用户配置文件——显示名称、头像 |
join_room |
通过ID或别名加入房间 |
leave_room |
离开房间 |
create_room |
创建新房间（可选择邀请） |
invite_user |
邀请用户到房间 |
send_reaction |
使用表情符号回复消息 |
resolve_alias |
解决 #alias:server 到房间ID |
安装
pip install mcp-server-matrix
或者用 紫外线:
uvx mcp-server-matrix
配置
设置环境变量：
| 变量 | 必填 | 描述 |
|---|---|---|
MATRIX_HOMESERVER |
是 | 家庭服务器URL（例如。 https://matrix.org) |
MATRIX_USER |
是 | 完整用户ID（例如。 @bot:matrix.org) |
MATRIX_PASSWORD |
是* | 帐户密码 |
MATRIX_ACCESS_TOKEN |
是* | 访问令牌（代替密码） |
MATRIX_STORE_PATH |
No | nio会话存储的路径（默认值： ~/.mcp-server-matrix/nio_store/) |
MCP_LOG_LEVEL |
否 | 日志级别：调试、信息、警告、错误（默认值：信息） |
*提供其中之一 MATRIX_PASSWORD 或 MATRIX_ACCESS_TOKEN.
用法
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"matrix": {
"command": "mcp-server-matrix",
"env": {
"MATRIX_HOMESERVER": "https://matrix.example.com",
"MATRIX_USER": "@bot:example.com",
"MATRIX_PASSWORD": "your-password"
}
}
}
}
克劳德代码
{
"mcpServers": {
"matrix": {
"command": "mcp-server-matrix",
"env": {
"MATRIX_HOMESERVER": "https://matrix.example.com",
"MATRIX_USER": "@bot:example.com",
"MATRIX_ACCESS_TOKEN": "syt_..."
}
}
}
}
龙虾
添加 openclaw.json:
{
"mcp": {
"servers": {
"matrix": {
"command": "mcp-server-matrix",
"env": {
"MATRIX_HOMESERVER": "https://matrix.example.com",
"MATRIX_USER": "@bot:example.com",
"MATRIX_PASSWORD": "your-password"
}
}
}
}
}
直接（stdio）
export MATRIX_HOMESERVER=https://matrix.example.com
export MATRIX_USER=@bot:example.com
export MATRIX_PASSWORD=your-password
mcp-server-matrix
例子
连接后，您的AI助手可以：
- 读取消息：“一般来说，最新消息是什么？”
- 发送消息：“向#announcements发送‘大家好！’”
- 管理房间：“创建一个名为‘Project X’的房间，并邀请@alice:matrix.org”
- 获取信息：“#teamchat中有多少成员？”
支持的家庭服务器
测试方法：
- 突触 （参考实施）
- 应适用于任何符合规范的家庭服务器（树突、导管等）
需求
- Python 3.10+
- 任何家庭服务器上的Matrix帐户
- 家庭服务器的网络访问
许可证
麻省理工学院
