使MCP服务器合法化
巴西律师的AI法律助理
阅读中文
MCP（模型上下文协议）服务器 合法 --巴西律师法律文件AI。
将Claude（或任何兼容MCP的客户）连接到您的Legalis帐户，并使用自然语言与案件交互、生成法律文件、搜索立法等。
快速开始
1.安装
pip install legalis-mcp
# or with uv:
uv tool install legalis-mcp
2.身份验证
这将打开您的浏览器。正常登录Legalis——令牌保存到 ~/.legalis/credentials.json （仅供所有者阅读）。
3.配置Claude
添加到您的Claude配置(~/.claude/claude_desktop_config.json 适用于克劳德桌面，或 claude_code_config.json 克劳德代码）：
{
"mcpServers": {
"legalis": {
"command": "legalis-mcp",
"args": ["serve"]
}
}
}
4.使用
在Claude中，尝试：
- “列出我的案件在法律”
- “为João Silva创建间接终止案件”
- “管理案件Y的X部分的法律依据部分”
- “为正义事业寻求劳动法”
- “这个月我还有多少代人？”
可用工具
病例
| 工具 |
说明 |
list_cases |
列出案例（分页，可按状态过滤） |
get_case |
按ID获取案件详细信息 |
create_case |
创建新案例 |
update_case |
更新案例字段 |
search_cases |
跨案例的全文搜索 |
delete_case |
永久删除案例 |
法律文件
| 工具 |
说明 |
list_legal_documents |
List process parts for a case |
get_legal_document |
获取包含所有部分的文档 |
create_legal_document |
创建新的法律文件 |
generate_section |
AI-generate a document section （事实、基础、请求…） |
update_section_text |
手动编辑文档部分 |
get_case_context |
获取案件背景（事实、当事人、证据） |
update_case_context |
更新案例背景 |
delete_legal_document |
删除法律文件 |
export_legal_document_docx |
将文档导出为DOCX |
事件和任务
| 工具 |
说明 |
create_case_event |
在案例中创建事件（内部或客户端可见） |
list_case_events |
列出案例的事件 |
delete_case_event |
删除案例事件 |
create_case_task |
创建具有截止日期和优先级的任务 |
list_case_tasks |
列出案例的任务 |
update_case_task |
更新任务的字段 |
complete_case_task |
将任务标记为已完成 |
delete_case_task |
删除任务 |
list_upcoming_tasks |
列出所有情况下即将进行的任务 |
list_overdue_tasks |
列出所有逾期任务 |
其他
| 工具 |
说明 |
run_interview |
人工智能引导的病例受理访谈 |
list_templates |
列出可用的文档模板 |
get_template |
获取模板详细信息和章节 |
search_legislation |
搜索巴西立法（LexML） |
get_my_usage |
检查AI配额和计费周期使用情况 |
API覆盖范围
下表将每个Legalis后端端点映射到其MCP工具（如果可用）。
病例
| 端点 |
方法 |
MCP工具 |
/api/cases |
得到 |
list_cases ✅ |
/api/cases |
职位 |
create_case ✅ |
/api/cases/{id} |
得到 |
get_case ✅ |
/api/cases/{id} |
PUT |
update_case ✅ |
/api/cases/{id} |
删除 |
delete_case ✅ |
/api/cases/search |
得到 |
search_cases ✅ |
/api/cases/{id}/overview |
获取 |
-- |
/api/cases/{id}/portal-token |
发布/删除 |
-- |
法律文件
| 端点 |
方法 |
MCP工具 |
/api/cases/{id}/legal-documents |
得到 |
list_legal_documents ✅ |
/api/cases/{id}/legal-documents |
职位 |
create_legal_document ✅ |
/api/cases/{id}/legal-documents/{doc} |
得到 |
get_legal_document ✅ |
/api/cases/{id}/legal-documents/{doc} |
删除 |
delete_legal_document ✅ |
/api/cases/{id}/legal-documents/{doc}/sections/{key}/generate |
职位 |
generate_section ✅ |
/api/cases/{id}/legal-documents/{doc}/sections/{key}/text |
PUT |
update_section_text ✅ |
/api/cases/{id}/legal-documents/{doc}/export/docx |
得到 |
export_legal_document_docx ✅ |
案例背景
| 端点 |
方法 |
MCP工具 |
/api/cases/{id}/context |
得到 |
get_case_context ✅ |
/api/cases/{id}/context |
PUT |
update_case_context ✅ |
/api/cases/{id}/context/history |
获取 |
-- |
任务
| 端点 |
方法 |
MCP工具 |
/api/cases/{id}/tasks |
得到 |
list_case_tasks ✅ |
/api/cases/{id}/tasks |
职位 |
create_case_task ✅ |
/api/cases/{id}/tasks/{task} |
PUT |
update_case_task ✅ |
/api/cases/{id}/tasks/{task} |
删除 |
delete_case_task ✅ |
/api/cases/{id}/tasks/{task}/complete |
职位 |
complete_case_task ✅ |
/api/tasks/upcoming |
得到 |
list_upcoming_tasks ✅ |
/api/tasks/overdue |
得到 |
list_overdue_tasks ✅ |
事件
| 端点 |
方法 |
MCP工具 |
/api/cases/{id}/events |
得到 |
list_case_events ✅ |
/api/cases/{id}/events |
职位 |
create_case_event ✅ |
/api/cases/{id}/events/{event} |
删除 |
delete_case_event ✅ |
模板和法规
| 端点 |
方法 |
MCP工具 |
/api/templates |
得到 |
list_templates ✅ |
/api/templates/{id} |
得到 |
get_template ✅ |
/api/legislacao |
得到 |
search_legislation ✅ |
用法
| 端点 |
方法 |
MCP工具 |
/api/plans/my-usage |
得到 |
get_my_usage ✅ |
尚未覆盖
| 端点 |
注释 |
/api/cases/{id}/overview |
BFF端点——一次调用中的案例+任务+事件 |
/api/cases/{id}/portal-token |
通过公共链接与客户共享案件状态 |
/api/cases/{id}/context/history |
上下文版本历史 |
/api/users/me |
用户配置文件读取/更新 |
/api/users/settings |
通知和UI首选项 |
/api/users/documents |
上传的文档（未生成） |
/api/voice-agent/* |
语音助手（计划门控功能） |
/api/corporates/{id}/users |
团队成员管理 |
/api/subordinates/invite |
邀请团队成员 |
CLI命令
legalis-mcp auth # Authenticate via browser
legalis-mcp serve # Start MCP server (stdio)
legalis-mcp status # Verify authentication
legalis-mcp logout # Remove stored credentials
发展
git clone <repo>
cd mcp
pip install -e ".[test]"
# Run unit tests (no external services needed)
pytest tests/unit/ -v
# Run integration tests (requires Docker)
cd ../integration && docker-compose up -d
cd ../mcp
LEGALIS_API_URL=http://localhost:8000 \
LEGALIS_ACCESS_TOKEN=<token> \
LEGALIS_REFRESH_TOKEN=<refresh> \
pytest tests/integration/ -v
环境变量
| 变量 |
默认值 |
描述 |
LEGALIS_API_URL |
https://hai-production-612f.up.railway.app |
后端URL |
LEGALIS_ACCESS_TOKEN |
-- |
预发行令牌（仅限CI/测试） |
LEGALIS_REFRESH_TOKEN |
-- |
刷新令牌（仅限CI/CD测试） |
LEGALIS_CREDENTIALS_FILE |
~/.legalis/credentials.json |
凭据文件路径 |
LEGALIS_OAUTH_PORT |
3742 |
本地OAuth回调端口 |
安全
- 凭据存储在
~/.legalis/credentials.json 随着 600 权限（仅限所有者读/写）。
- OAuth重定向仅限于
http://localhost --开放重定向攻击在后端被阻止。
- 令牌从不存储在MCP配置文件中。
- 所有API调用都通过现有的Legis后端-RBAC、速率限制和配额正常应用。
出版
# PyPI
pip install build twine
python -m build
twine upload dist/*
# Then register at:
# - smithery.ai (MCP marketplace)
# - mcp.so (community directory)
# - github.com/modelcontextprotocol/servers (official list)
