AI导哈

法律本体搜索工具

FOLIO-MCP是一个基于FOLIO法律本体的搜索工具，提供18,000多个法律概念的搜索和浏览功能，适用于AI助手和代理框架。

  • by alea-institute
  • Python
  • 混合部署
  • 5 星标
  • 更新于
在 GitHub 查看 alea-institute/folio-mcp

使用说明

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

链接

相关 MCP