leaseclear-mcp

leaseclear-mcp

LeaseClear のリースに関する Q&A を提供する Model Context Protocol サーバーです。

公式 MCP Registry に io.github.amadeuserras/leaseclear-mcp として登録されています。

ツール

• lease_qa — リース条件について質問を 1 つ受け付けます。リースに基づく回答を返すか、リースに記載がないことを伝えます

使用方法

MCP クライアントの設定ファイル（例：claude_desktop_config.json または Cursor の mcp.json）に以下を追加します。

{
  "mcpServers": {
    "lease-qa": {
      "command": "uvx",
      "args": ["leaseclear-mcp"]
    }
  }
}

パッケージは PyPI で公開されています。uvx はパッケージを取得し、ローカルのサブプロセスとして実行して、stdio 経由で通信します。uv が必要です。

オプションの環境変数

変数	説明	デフォルト
LEASECLEAR_API_KEY	独自の LeaseClear アカウントでサーバーを使用します	LeaseClear のデモモード
LEASECLEAR_API_URL	API エンドポイントを上書きします（ローカルまたはプライベートなインスタンス）	LeaseClear の本番バックエンド

{
  "mcpServers": {
    "lease-qa": {
      "command": "uvx",
      "args": ["leaseclear-mcp"],
      "env": {
        "LEASECLEAR_API_KEY": "lc_...",
        "LEASECLEAR_API_URL": "https://..."
      }
    }
  }
}

lease_qa の使用方法

引数

• question（string、必須）— リースについての質問を 1 つ指定します

_meta

• document_ids（string[]、任意）— クエリ対象のドキュメントの UUID。省略するとすべてが対象になります。

セキュリティ：_meta フィールドは、モデルには見えないメタデータをツール呼び出しに渡すために使用します。ここに document_ids を含めるのは意図的です。モデルがアクセス可能なドキュメントを選べないため、ドキュメントをまたいだプロンプトインジェクションを防止できます。LeaseOps: prompt injection and the tenants table に実例があります。

MCP Python SDK の例

ツール呼び出し：

result = await session.call_tool(
    name="lease_qa",
    arguments={
        "question": "How much is the security deposit for Yuna Kim?"
    },
    meta={
        "document_ids": [
            "a1b2c3d4-e5f..."
        ]
    }
)

出力：

{
  "answer": "The security deposit is $6,400.00. This deposit is held in Owner's Broker's trust account [california-johnson-kim §4]."
}

技術スタック

• Python 3.12
• stdio 経由の Model Context Protocol Python SDK（mcp[cli]）
• LeaseClear API 呼び出し用の httpx
• スキーマと設定用の Pydantic および pydantic-settings
• 実行とパッケージ化用の uv および uv_build
• テスト、リンティング、型チェック用の pytest、Ruff、Pyright

プロジェクト構成

leaseclear-mcp/
├── src/leaseclear_mcp/
│   ├── server.py        # MCP server + lease_qa
│   ├── leaseclear.py    # LeaseClear HTTP client
│   ├── schemas.py
│   └── config.py
├── tests/
├── pyproject.toml
├── .env.example
└── README.md

ローカル開発

git clone https://github.com/you/leaseclear-mcp.git
cd leaseclear-mcp
uv sync
cp .env.example .env
uv run pytest
uv run ruff check .
uv run pyright

デバッグ

MCP Inspector を使用して、サーバーを対話的にテストします。

npx @modelcontextprotocol/inspector uvx leaseclear-mcp

チェックアウトしたリポジトリから実行する場合は、uvx leaseclear-mcp の代わりに uv run leaseclear-mcp を使用します。

ライセンス

MIT