使MCP服务器合法化
巴西律师的AI法律助理
阅读中文
MCP(模型上下文协议)服务器 合法 --巴西律师法律文件AI。
将Claude(或任何兼容MCP的客户)连接到您的Legalis帐户,并使用自然语言与案件交互、生成法律文件、搜索立法等。
______________________________________________________________________
快速开始
1.安装
pip install legalis-mcp
# or with uv:
uv tool install legalis-mcp2.身份验证
legalis-mcp auth这将打开您的浏览器。正常登录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
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= \
LEGALIS_REFRESH_TOKEN= \
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)