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帐户
本地设置
- 克隆或导航到存储库
cd Lawmatics-MCP- 安装依赖项
uv sync- 配置环境变量
cp .env.example .env
# Edit .env and add your LAWMATICS_API_KEY- 配置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设置指南）
- 在本地运行服务器
uv run python -m app服务器将于启动 http://localhost:8000/mcp/
FastMCP云部署
部署到FastMCP云
- 推送到GitHub
git init
git add .
git commit -m "Initial Lawmatics MCP Server"
git remote add origin
git push -u origin main- 在FastMCP云上部署
- 访问 https://fastmcp.cloud - 使用GitHub登录 - 点击“新建项目” - 选择您的存储库 - 配置： - 名字: lawmatics-mcp （创建 https://lawmatics-mcp.fastmcp.app/mcp) - 入口点: cloud.py:mcp - 分支: main
- 在FastMCP Cloud仪表板中添加环境变量
LAWMATICS_API_KEY=your_actual_api_key_here
LAWMATICS_BASE_URL=https://api.lawmatics.com/v1/
LOG_LEVEL=INFO- 部署
- 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
支持
- API法律文档: https://docs.lawmatics.com
- 法律API支持: api@lawmatics.com
- FastMCP文档: https://gofastmcp.com
- MCP规范: https://spec.modelcontextprotocol.io/
许可证
\[您的许可证在这里\]
贡献
欢迎投稿！请随时提交拉取请求。