PropXchain

@propxchain/mcp-server

适用于 PropXchain 的 MCP 服务。PropXchain 是英国的房屋买卖平台，为卖家、买家、产权转让律师和房产中介提供一份共享的实时交易记录。（与无关的加密代币 Propchain/PROPC 无关。）

你的 AI 助手可以使用邀请代码加入你的交易，读取状态、清单、文档和审计跟踪，获取英国土地注册处和房产数据，解释每个步骤，并起草发给其他各方的消息。资金和法律相关步骤仍需由你操作。

连接（托管，无需安装）

PropXchain 会为你运行此服务，地址如下：

https://mcp.propxchain.com/mcp

• **claude.ai / Claude Desktop：**依次点击 Settings、Connectors、Add custom connector，粘贴 URL，并将 client ID 和 secret 留空。
• Claude Code：claude mcp add --transport http propxchain https://mcp.propxchain.com/mcp
• **ChatGPT、Cursor 和其他 MCP 客户端：**使用上方 URL 添加远程（Streamable HTTP）服务。系统会自动发现 OAuth 2.1 登录方式。

使用你的 PropXchain 邮箱和 6 位数验证码批准连接，然后向助手提供 TX-XXXX-XXXX 邀请代码。你可以随时在交易的机器人面板中移除它。

完整设置指南：propxchain.com/agent。 机器可读清单：propxchain.com/.well-known/mcp.json。 注册表条目：server.json（io.github.Madhatt4/propxchain）。

改为在本地运行（stdio）

适用于不支持远程 MCP 的客户端。首次启动时，本地服务会生成自己的 Ed25519 密钥对（存储在磁盘上，不会跨边界复制）；访问权限仍按交易通过邀请代码控制。

npm install -g @propxchain/mcp-server

然后将其添加到 Claude Desktop 配置中（Windows：%APPDATA%/Claude/claude_desktop_config.json；macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Linux：~/.config/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "propxchain": {
      "command": "propxchain-mcp-server",
      "env": { "IC_NETWORK": "ic" }
    }
  }
}

对于 Claude Code，对应的单条命令为：

claude mcp add propxchain propxchain-mcp-server -e IC_NETWORK=ic

重启你的 Agent。在新的聊天中询问：

以名为 "Claude Desktop" 的机器人身份加入 propxchain 交易 TX-XXXX-XXXX

（从 propxchain.com 上任一交易的分享面板中获取邀请代码。）

身份模型

首次启动时，服务会读取或创建 Ed25519 种子，路径如下：

• macOS / Linux：~/.config/propxchain-mcp/identity.key（如果设置了 $XDG_CONFIG_HOME，则为 $XDG_CONFIG_HOME/propxchain-mcp/identity.key）
• Windows：%APPDATA%/propxchain-mcp/identity.key

在 POSIX 系统上，该文件的权限为 chmod 600，其中包含一个经过 base64 编码的 32 字节种子，末尾带有换行符。机器人的主体由此种子派生，并会在启动时输出到 stderr。

运维或 CI 可通过在环境中设置 BOT_PRIVATE_KEY 来覆盖：其值为经过 base64 编码的 32 字节种子。设置后，服务会使用该值，而不从磁盘读取。

工具

17 个工具，分属以下类别：

类别	工具
机器人管理	propxchain_join_transaction_as_bot、propxchain_list_my_transactions、propxchain_list_connected_bots
交易	propxchain_search_transactions、propxchain_get_transaction、propxchain_get_status、propxchain_create_transaction、propxchain_join_transaction、propxchain_get_transaction_chain
文档	propxchain_verify_document、propxchain_list_documents、propxchain_upload_document
清单	propxchain_get_checklist、propxchain_update_checklist
房产信息	propxchain_get_property_intel
指引	propxchain_explain_process、propxchain_send_message

每个工具的完整架构都可通过标准 MCP tools/list 调用获取。

安全模型

• 机器人主体只能看到用户通过邀请码授权的交易。
• 除获授权的交易外，不提供任何涉及资金、签名或交易的写入接口。
• 可在 propxchain.com 机器人面板中一键撤销；此操作会在链上调用 transaction_manager.disconnectBot。
• 种子文件保存在用户的本地设备上。npm 包不包含任何凭据。
• 每次发布都会启用 npm 来源证明；可通过 npm view @propxchain/mcp-server 验证。

从源代码构建

git clone https://github.com/Madhatt4/propxchain-mcp-server.git
cd propxchain-mcp-server
npm install
npm run build

npm run build 会编译 TypeScript，并在 dist/index.js 前添加 #!/usr/bin/env node shebang（在 tsc 编译后添加，因为 tsc 会移除它）。直接测试该二进制文件：

node dist/index.js

服务会读取/创建上述本地身份文件。若要对 MCP 协议进行冒烟测试，可通过管道发送 initialize + tools/list 请求：

( printf '%s\n' \
    '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
    '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
    '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' ; \
  sleep 2 ) | node dist/index.js

你应该会在 stderr 中看到机器人主体，在 stdout 中看到工具列表。

版本管理

发布通过 gh workflow run release.yml --field dry-run=false 手动进行。请先更新 package.json 中的 version；工作流会拒绝重新发布已存在的版本，也会拒绝在 latest 标签上发布带预发布后缀的版本。发布前的预发布验证会运行上文所示的同一项 MCP 冒烟测试。

许可证

UNLICENSED。可自由安装 npm 包，以便对 PropXchain canisters 使用；不授予重新分发和修改的权利。