leaseclear-mcp

leaseclear-mcp

一个 Model Context Protocol 服务，用于提供 LeaseClear 租约问答功能。

已列入官方 MCP 注册表，注册名称为 io.github.amadeuserras/leaseclear-mcp。

工具

• lease_qa — 提出一个有关租约条款的问题；返回基于租约的答案，或说明租约中未提及相关内容

用法

将以下内容添加到 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，必填）— 一个有关租约的问题

_meta

• document_ids（string[]，可选）— 要查询的文档 UUID。省略时表示查询全部文档。

安全性：_meta 字段用于向工具调用传递模型不可见的元数据。将 document_ids 放在此处是有意为之：这样可以防止跨文档提示词注入，因为模型无法选择自己有权访问哪些文档。请参阅 LeaseOps：提示词注入与租户表中的真实案例。

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]）
• 使用 httpx 调用 LeaseClear API
• 使用 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

从代码仓库检出目录运行时，请使用 uv run leaseclear-mcp，而不是 uvx leaseclear-mcp。

许可证

MIT