AI导哈

法律实践管理协议服务器

Lawmatics MCP服务器是一个为法律实践管理平台设计的协议服务器，支持通过LLM管理联系人、案件、任务、时间记录和费用等。

  • by martyvasquez
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 martyvasquez/lawmatics-mcp-v1.0

使用说明

Lawmatics MCP服务器

Lawmatics法律实践管理平台的模型上下文协议（MCP）服务器。此服务器使LLM能够与Lawmatics交互，以管理联系人、事项、任务、时间条目、费用等。

🔐 身份验证说明：Lawmatics使用OAuth 2.0。看 OAuth设置指南 获取完整的设置说明，包括回调URL和凭据配置。

特性

🔍 搜索操作

  • 联系人：按姓名、电子邮件、电话或相关事项/公司搜索
  • 事务：按姓名、联系人、状态或执业领域搜索
  • 任务：按联系人、事项、状态、受让人或到期日搜索
  • 公司：按姓名、电子邮件或电话搜索
  • 时间条目：按联系人、事项、用户或日期范围搜索
  • 开支：按联系人、事项或日期范围搜索

📋 检索操作

  • 按ID获取任何实体的详细信息
  • 列出帐户中的所有用户
  • 访问完整的实体数据，包括自定义字段

✏️ 管理操作

  • 创建：联系人、任务、时间条目、费用
  • 更新：联系人、任务
  • 删除：任务

🎯 MCP资源

对实体的直接URI访问：

  • lawmatics://contacts/{contact_id}
  • lawmatics://matters/{matter_id}
  • lawmatics://tasks/{task_id}
  • lawmatics://companies/{company_id}

📝 MCP提示

常见操作的预构建工作流程：

  • 通过电话查找联系人：按电话号码查找所有联系人和事项
  • 事项概述：对任务和计费进行全面的事项分析
  • 创建新客户端：完成客户入职流程
  • 每日任务摘要：今天的任务和即将到来的截止日期
  • 账单报告：生成时间和费用报告
  • 物质搜索分析：按标准搜索和分析事项

安装

先决条件

  • Python 3.12或更高版本
  • 紫外线 包管理器
  • 具有API访问权限的Lawmatics帐户

本地设置

  1. 克隆或导航到存储库

    cd Lawmatics-MCP

  2. 安装依赖项

    uv sync

  3. 配置环境变量

    cp .env.example .env
# Edit .env and add your LAWMATICS_API_KEY

  4. 配置OAuth凭据

    ⚠️ Lawmatics使用OAuth 2.0身份验证

    看 OAuth设置指南 详细说明。

    快速开始:

    • 转到法律设置→ API → OAuth应用程序
    • 使用回调URL创建新的OAuth应用程序： http://localhost:8000/oauth/callback
    • 复制您的客户端ID和客户端密码
    • 将它们添加到您的 .env 文件：
      LAWMATICS_CLIENT_ID=your_client_id_here
LAWMATICS_CLIENT_SECRET=your_client_secret_here
    • 完成OAuth流程以获取访问令牌（请参阅OAuth设置指南）

  5. 在本地运行服务器

    uv run python -m app

    服务器将于启动 http://localhost:8000/mcp/

FastMCP云部署

部署到FastMCP云

  1. 推送到GitHub

    git init
git add .
git commit -m "Initial Lawmatics MCP Server"
git remote add origin <your-repo-url>
git push -u origin main

  2. 在FastMCP云上部署

    • 访问 https://fastmcp.cloud
    • 使用GitHub登录
    • 点击“新建项目”
    • 选择您的存储库
    • 配置：
      • 名字: lawmatics-mcp （创建 https://lawmatics-mcp.fastmcp.app/mcp)
      • 入口点: cloud.py:mcp
      • 分支: main

  3. 在FastMCP Cloud仪表板中添加环境变量

    LAWMATICS_API_KEY=your_actual_api_key_here
LAWMATICS_BASE_URL=https://api.lawmatics.com/v1/
LOG_LEVEL=INFO

  4. 部署

    • FastMCP Cloud将自动构建和部署
    • 您的服务器将在以下位置可用： https://lawmatics-mcp.fastmcp.app/mcp

自动更新

当您推送到主分支时，FastMCP Cloud会自动重新部署：

git add .
git commit -m "Update tools"
git push origin main

用法

开发命令

# Run server locally
uv run python -m app

# Run with FastMCP dev mode (hot reload)
fastmcp dev cloud.py:mcp

# Inspect server structure
fastmcp inspect cloud.py:mcp

# Run tests
uv run pytest

# Run tests with coverage
uv run pytest --cov=app --cov-report=term-missing

# Type checking
uv run mypy app/

# Code formatting
uv run ruff format .

# Linting
uv run ruff check .

查询示例

运行后，您可以通过任何兼容MCP的客户端与MCP服务器交互：

通过电话查找联系人：

Use the find-contact-by-phone prompt with phone_number: 714-917-5140

搜索事项：

Use search_matters tool with practice_area: "Personal Injury" and status: "active"

创建新任务：

Use create_task tool with title: "Follow up with client", matter_id: "123", due_date: "2025-11-01"

获取事件概述：

Use matter-overview prompt with matter_id: "456"

API覆盖范围

支持的实体

  • ✅ 联系人（潜在客户、客户、推荐人）
  • ✅ 事项（案件）
  • ✅ 任务
  • ✅ 公司
  • ✅ 时间条目
  • ✅ 开支
  • ✅ 用户

支持的操作

  • ✅ 搜索/列表过滤
  • ✅ 按ID获取
  • ✅ 创建新实体
  • ✅ 更新现有实体
  • ✅ 删除实体（任务）

配置

环境变量

变量 必填 默认 描述
LAWMATICS_API_KEY 是 - 您的Lawmatics API密钥
LAWMATICS_BASE_URL 没有 https://api.lawmatics.com/v1/ 法律API基础URL
HOST 没有 0.0.0.0 服务器主机
MCP_PORT 没有 8000 服务器端口
LOG_LEVEL 没有 INFO 日志记录级别
DEBUG 没有 false 调试模式
ENVIRONMENT 没有 production 环境名称

建筑

项目结构

Lawmatics-MCP/
├── app/
│   ├── __init__.py           # Package initialization
│   ├── __main__.py          # Entry point
│   ├── config.py            # Configuration management
│   ├── server.py            # Main MCP server
│   └── tools/               # Tool modules
│       ├── __init__.py      # Tools package
│       ├── search.py        # Search operations
│       ├── get.py          # Get operations
│       └── manage.py       # Create/update/delete operations
├── tests/                   # Test suite
├── cloud.py                # FastMCP Cloud entrypoint
├── pyproject.toml          # Dependencies
├── .env.example           # Environment template
└── README.md             # This file

服务器组成

MCP服务器使用FastMCP的组合模式：

  • 主服务器：状态工具、资源和提示
  • 搜索服务器：6个搜索工具（联系人、事项、任务等）
  • 获取服务器：8个检索工具（按ID获取，列出用户）
  • 管理服务器：7个管理工具（创建、更新、删除）

总计： 22个工具+4个资源+6个提示

故障排除

API关键问题

  • 确保您的 LAWMATICS_API_KEY 在中设置正确 .env 或FastMCP云
  • 通过使用curl测试密钥来验证其有效性：
    curl -X GET "https://api.lawmatics.com/v1/users" \
  -H "Authorization: Bearer YOUR_API_KEY"

连接问题

  • 检查一下 LAWMATICS_BASE_URL 指向正确的API终结点
  • 验证与api.lawmatics.com的网络连接
  • 检查FastMCP Cloud日志以获取详细的错误消息

工具发现

  • 跑 fastmcp inspect cloud.py:mcp 验证所有工具是否已加载
  • 确保子服务器在中正确导入 app/tools/__init__.py

支持

许可证

[您的许可证在这里]

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP