Tlon MCP服务器
MCP（模型上下文协议）服务器，提供与Tlon代理交互的工具。
演示
https://github.com/user-attachments/assets/765847b2-df40-44c0-bfd3-c23eb609bbd8
特性
- 发送dm工具：通过船只ID或昵称向其他用户发送直接消息
- 读取dm历史记录工具：从直接消息通道检索最近的消息
- 列表联系人工具：获取联系人的昵称和船只ID
- 自然语言支持：通过昵称推荐人（“给Brian发信息”）
先决条件
- Node.js（v16+）
- 一艘行驶中的Urbit船
安装
- 克隆存储库
- 导航到项目目录
- 安装依赖项：
npm install重要提示： 始终运行 npm install 在与Claude Desktop或任何其他MCP客户端一起使用之前，请在终端中手动操作。这可以防止安装输出干扰MCP协议。
配置
使用环境变量配置服务器：
| 变量 | 描述 | 默认值 |
|---|---|---|
URBIT_SHIP | 您的Urbit船名（不含~） | zod |
URBIT_CODE | 您的Urbit+代码 | lidlut标签pillex ridrup |
URBIT_HOST | Urbit主机 | 本地主机 |
URBIT_PORT | 乌尔比港 | 8080 |
PORT | MCP服务器端口（仅HTTP模式） | 3001 |
MCP_TRANSPORT | 传输类型（http或stdio） | stdio |
用法
启动服务器
# Start with default stdio transport
npm start
# Start with HTTP transport
export MCP_TRANSPORT=http && npm start
# Development mode with auto-reload
npm run dev使用Claude Desktop进行设置
默认的stdio模式与Claude Desktop无缝协作。在以下位置创建或编辑Claude Desktop配置文件：
~/Library/Application Support/Claude/claude_desktop_config.json内容如下：
{
"mcpServers": {
"tlon-mcp": {
"command": "/bin/sh",
"args": ["-c", "cd /path/to/server && node index.js"]
}
}
}重要提示： 一定要跑 npm install 在配置Claude Desktop之前，请先在服务器目录中。
使用自然语言工具
配置后，您可以使用自然语言命令：
Send a message to BrianShow me my recent DM history with ~sampel-palnetWho are my contacts?可用工具
发送dm
向另一艘船发送直接信息。
参数：
recipient：收件人的船名（带~）或昵称message：要发送的消息文本
示例用法：
Send a message to Brian saying "Let's meet tomorrow"读取dm历史记录
从您的船和另一艘船之间的直接消息通道获取最新消息。
参数：
correspondent：另一艘船的名称（带~）或昵称count（可选）：返回多少条消息（默认100条，最多500条）format（可选）：输出格式-“原始”或“格式化”（默认“格式化”）
示例用法：
Show me my last 50 messages with Dad列出联系人
使用船只ID和昵称检索您的联系人列表。
参数：
format（可选）：输出格式-“原始”或“格式化”（默认“格式化”）
示例用法：
List all my contacts许可证
麻省理工学院
