Tlon MCP Server

Tlon MCP 服务

一个用于与 Tlon Agent 交互的 MCP（Model Context Protocol）服务，提供相关工具。

演示

https://github.com/user-attachments/assets/765847b2-df40-44c0-bfd3-c23eb609bbd8

功能

• send-dm 工具：通过飞船 ID 或昵称向其他用户发送私信
• read-dm-history 工具：获取私信频道中的近期消息
• list-contacts 工具：获取包含昵称和飞船 ID 的联系人
• 自然语言支持：通过昵称指代联系人（“给 Brian 发条消息”）

前置条件

• Node.js（v16+）
• 正在运行的 Urbit 飞船

安装

1. 克隆仓库
2. 切换到项目目录
3. 安装依赖项：

npm install

重要： 使用 Claude Desktop 或任何其他 MCP 客户端之前，务必先在终端中手动运行 npm install。这样可以避免安装输出干扰 MCP 协议。

配置

使用环境变量配置服务：

变量	描述	默认值
URBIT_SHIP	你的 Urbit 飞船名称（不含 ~）	zod
URBIT_CODE	你的 Urbit +code	lidlut-tabwed-pillex-ridrup
URBIT_HOST	Urbit 主机	localhost
URBIT_PORT	Urbit 端口	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"]
    }
  }
}

重要： 配置 Claude Desktop 之前，务必先在服务目录中运行 npm install。

使用自然语言调用工具

配置完成后，你可以使用自然语言命令：

Send a message to Brian

Show me my recent DM history with ~sampel-palnet

Who are my contacts?

可用工具

send-dm

向另一艘飞船发送私信。

参数：

• recipient：收件人的飞船名称（含 ~）或昵称
• message：要发送的消息文本

使用示例：

Send a message to Brian saying "Let's meet tomorrow"

read-dm-history

获取你的飞船与另一艘飞船之间的私信频道中的最新消息。

参数：

• correspondent：另一艘飞船的名称（含 ~）或昵称
• count（可选）：返回的消息数量（默认 100，最大 500）
• format（可选）：输出格式——“raw”或“formatted”（默认“formatted”）

使用示例：

Show me my last 50 messages with Dad

list-contacts

获取包含飞船 ID 和昵称的联系人列表。

参数：

• format（可选）：输出格式——“raw”或“formatted”（默认“formatted”）

使用示例：

List all my contacts

许可证

MIT