PropXchain

@propxchain/mcp-server

PropXchain 向けの MCP サーバーです。PropXchain は、英国で住宅を売買するためのプラットフォームです。売主、買主、コンベヤンサー、エステートエージェントが、取引の最新情報を共有する単一の記録を利用できます。（無関係な暗号資産トークンの Propchain/PROPC とは異なります。）

AI アシスタントは招待コードを使って取引に参加し、状況、チェックリスト、書類、監査証跡を確認できます。また、HM Land Registry や不動産のデータを取得し、各手順を説明して、関係者へのメッセージを下書きできます。金銭や法的な手続きは、引き続きお客様自身の承認を待ちます。

接続（ホスト型、インストール不要）

PropXchain は次の場所でこのサーバーを実行します。

https://mcp.propxchain.com/mcp

• claude.ai / Claude Desktop：「Settings」から「Connectors」、「Add custom connector」の順に選び、URL を貼り付けます。クライアント ID とシークレットは空欄のままにします。
• 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

エージェントを再起動します。新しいチャットで、次のように依頼します。

propxchain の取引 TX-XXXX-XXXX に「Claude Desktop」という名前のボットとして参加してください

（招待コードは、propxchain.com の取引共有パネルで確認できます。）

ID モデル

初回起動時に、サーバーは次の場所にある 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 バイトのシードが 1 つだけ含まれます。ボットのプリンシパルはこのシードから導出され、起動時に標準エラー出力へ表示されます。

運用環境や 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 シバンを追加します（tsc がシバンを削除するため、コンパイル後に追加されます）。バイナリを直接テストします。

node dist/index.js

サーバーは前述のとおり、ローカルの ID ファイルを読み込み、または作成します。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 canister で使用するために自由にインストールできますが、再配布および改変の権利は許諾されていません。