mcp组合
MCP服务器 卷宗,the F联合国 O钢笔 L平等 一、信息 O生物学。
FOLIO是一个开源的法律本体论,拥有18000多个概念,涵盖法律、文件类型、法律实体、政府机构等领域。此MCP服务器将完整的本体作为可搜索、可浏览的工具提供给AI代理。
公共REST API已在 https://folio.openlegalstandard.org/ 交互式Swagger文档位于 /docs此MCP服务器封装了相同的本体,用于AI编码助手和代理框架中的本地使用。
许可证: MIT(服务器代码)/CC-BY4.0(本体数据)
后端
folio mcp支持两个可互换的后端:
| 模式 | 启动 | 依赖关系 | 用例 |
|---|---|---|---|
| API (默认) | 即时 | httpx 仅 | 正常使用-调用公共FOLIO REST API |
本地 (--local) | ~10s | folio-python[search] | 离线使用或在folio api内部挂载时 |
API模式(默认)
服务器立即启动,并将所有查询委托给位于的公共API https://folio.openlegalstandard.org/。不需要加载本地本体。
本地模式
在进程中加载完整的FOLIO本体(约18k个类)。适用于离线工作或嵌入对开api时。
# Install with local dependencies
pip install folio-mcp[local]
# Run in local mode
folio-mcp --local
# Or via environment variable
FOLIO_MCP_LOCAL=1 folio-mcp自定义API URL
指向不同的FOLIO API实例:
folio-mcp --api-url https://my-folio-instance.example.com安装
克劳德代码
claude mcp add folio -- uvx folio-mcp克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"folio": {
"command": "uvx",
"args": ["folio-mcp"]
}
}
}光标
添加 .cursor/mcp.json 在您的项目中:
{
"mcpServers": {
"folio": {
"command": "uvx",
"args": ["folio-mcp"]
}
}
}VS Code
添加到用户设置(JSON):
{
"mcp": {
"servers": {
"folio": {
"command": "uvx",
"args": ["folio-mcp"]
}
}
}
}远程(流式HTTP)
连接到托管端点:
https://folio.openlegalstandard.org/mcp手动(pip)
pip install folio-mcp
folio-mcp工具(12)
| 工具 | 说明 |
|---|---|
search_concepts(query, limit=10) | 使用模糊匹配按标签/名称搜索概念 |
search_definitions(query, limit=10) | 按定义文本搜索概念 |
query_concepts(...) | 具有可组合文本和结构过滤器的高级查询 |
query_properties(...) | 按标签、域、范围查询OWL对象属性 |
get_concept(iri) | 通过IRI获取概念的完整细节 |
export_concept(iri, format) | 将概念导出为markdown、JSON-LD或OWL XML |
list_branches() | 列出所有24个具有概念计数的分类分支 |
get_taxonomy_branch(branch_name, max_depth) | 在分类分支中获取概念 |
get_children(iri, max_depth) | 获取儿童概念 |
get_parents(iri, max_depth) | 获取父概念 |
get_properties() | 获取所有OWL对象属性(关系) |
find_connections(subject_iri, property_name, object_iri) | 查找语义三元组 |
浏览操作返回精简摘要(iri、标签、定义)。使用 get_concept(iri) 了解完整的细节,包括翻译(31%的概念,10多种语言)、首选标签、外部标识符和交叉引用。
提示(3)
| 提示 | 描述 | 参数 |
|---|---|---|
classify-document | 根据FOLIO分类法对法律文件进行分类 | description |
identify-area-of-law | 确定适用于某一情况的法律领域 | situation |
classify-entity | 对法人实体(个人、组织、角色)进行分类 | entity |
每个提示都引导LLM完成正确的工具工作流程,并返回结构化输出(FOLIO标签、IRI、定义、置信度、推理)。
资源(3)
| 资源URI | 描述 |
|---|---|
folio://branches | 具有概念计数的分支名称(564字节) |
folio://stats | 本体统计——版本、类/属性计数、许可证 |
folio://branch/{name} | 特定分支中的顶级概念(按需) |
分类学分支
FOLIO本体分为24个顶级分支:
| 分支 | 描述 |
|---|---|
actors_players | 法律事务中的各方、角色和参与者 |
areas_of_law | 法律实践领域和专业 |
asset_types | 资产类型(不动产、知识产权等) |
communication_modalities | 沟通渠道和方法 |
currencies | 货币 |
data_formats | 数据和文件格式 |
document_artifacts | 法律文件、合同、文件 |
engagement_terms | 聘用条款和费用安排 |
events | 法律事件和里程碑 |
forum_venues | 法院、法庭和争议解决场所 |
governmental_bodies | 政府机构和部门 |
industries | 行业部门和分类 |
languages | 自然语言 |
folio_types | FOLIO内部类型分类 |
legal_authorities | 法规、条例、判例法 |
legal_entities | 实体类型(公司、有限责任公司、信托等) |
locations | 地理位置和管辖区 |
matter_narratives | 物质描述和叙述 |
matter_narrative_formats | 事件叙述的格式 |
objectives | 法律目的和目标 |
services | 法律服务和服务类型 |
standards_compatibilities | 标准和兼容性映射 |
statuses | 事项、文件等的状态值。 |
system_identifiers | 系统和外部标识符 |
发展
# Clone and install
git clone https://github.com/alea-institute/folio-mcp.git
cd folio-mcp
uv sync
# Run tests (requires folio-python for local backend tests)
uv sync --extra local
uv run pytest tests/
# Run with MCP Inspector
uv run mcp dev folio_mcp/server.py
# Run locally for Claude Code
claude mcp add folio-dev -- uv run --directory /path/to/folio-mcp folio-mcp链接
- FOLIO网站
- FOLIO REST API -用于直接HTTP访问的公共API
- FOLIO API文档(Swagger) -交互式API文档
- 对开python --Python客户端库
- 对开api -REST API服务器
- ALEA研究所
