MCP-业务操作引擎

Name: MCP-业务操作引擎
Author: ComputingVictor

作者：ComputingVictor26 星标更新：2025-09-10

安装使用来源：spider==github.com

项目介绍

MCP BOE 🇪🇸

西班牙官方公报的模型上下文协议

这是一个MCP服务器，允许Claude和其他大型语言模型访问官方BOE API，以查询西班牙政府的立法、每日摘要和辅助表格。

🚀 特性

🔍 搜索立法：搜索超过50,000条已整合的标准
📰 BOE摘要：访问BOE和BORME每日出版物
🏛️ 辅助表格：查询部门、主题和规范范围的代码
⚡ API REST：HTTP接口，可从任何应用程序使用
🤖 兼容MCP：与Claude Code、Ollama和其他MCP客户端兼容
📊 官方数据：直接连接到官方BOE API

📋 目录

安装
快速使用
与Claude配置
[API REST](#-API REST)
示例
可用工具
贡献
许可证

🛠️ 安装

预备条件

Python 3.8或更高版本
pip（Python包管理器）

使用uvx快速安装（推荐）

如果你已经安装了uvx，你可以直接使用MCP服务器而无需手动安装：

# 检查uvx是否已安装
uvx --version

# 直接从仓库执行
uvx --from git+https://github.com/ComputingVictor/MCP-BOE.git mcp-boe --help

从源代码安装

# 克隆仓库
git clone https://github.com/ComputingVictor/MCP-BOE.git
cd MCP-BOE

# 安装基本依赖
pip install -e .

# 或者安装带有API REST的依赖
pip install -e ".[api]"

# 或者安装全部用于开发的依赖
pip install -e ".[dev]"

验证安装

# 快速测试连通性
python examples/basic_usage.py connectivity

# 测试全部功能
python examples/basic_usage.py quick

⚡ 快速使用

连通性测试

# 检查一切是否正常工作
python examples/basic_usage.py connectivity

交互式演示

# 交互式探索功能
python examples/basic_usage.py interactive

具体示例

# 搜索立法
python examples/basic_usage.py search

# 查看BOE摘要
python examples/basic_usage.py summary

# 查询部门
python examples/basic_usage.py departments

🔧 与Claude配置

Claude Code（推荐）

方案1：使用uvx（推荐简化操作）

uvx 是一个大大简化Python包安装和执行的工具。使用UVX，你不需要：

手动创建虚拟环境
安装依赖
配置环境变量如PYTHONPATH

uvx会自动创建一个隔离环境并下载所有必要的依赖。

直接使用UVX：

{
  "mcpServers": {
    "mcp-boe": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ComputingVictor/MCP-BOE.git", "mcp-boe"],
      "transport": "stdio"
    }
  }
}

你也可以使用包含的示例配置文件：

# 下载并使用示例配置
curl -O https://raw.githubusercontent.com/ComputingVictor/MCP-BOE/main/claude_mcp_config_uvx.json

在Claude Code中配置：

# 使用自定义配置
/config-mcp /路径/到/你的/claude_mcp_config.json

# 或使用示例配置
/config-mcp claude_m

方案2：传统安装

创建MCP配置文件：

{
  "mcpServers": {
    "mcp-boe": {
      "command": "/路径/到/你的/conda/envs/你的环境/bin/python",
      "args": ["-m", "mcp_boe.server"],
      "transport": "stdio",
      "env": {
        "PYTHONPATH": "/路径/到/你的/MCP-BOE/src"
      }
    }
  }
}

在Claude Code中配置：

/config-mcp /路径/到/你的/claude_mcp_config.json

在Claude中使用：

你能查找关于《2015年第40号法律》的信息吗？
显示本周的BOE摘要
哪些部门包含“部”这个词？

Ollama + 开放WebUI

# 安装开放WebUI
pip install open-webui

# 配置环境变量
export PYTHONPATH=/路径/到/你的/MCP-BOE/src

# 启动服务
ollama serve &
open-webui serve

🌐 API REST

要从web、移动设备或任何HTTP客户端使用：

启动API服务器

python rest_api_wrapper.py

API将在以下地址可用：http://localhost:8000 交互式文档：http://localhost:8000/docs

可用端点

🔍 搜索立法

curl -X POST "http://localhost:8000/search/legislation" \
-H "Content-Type: application/json" \
-d '{"query": "西班牙宪法", "limit": 5}'

📰 BOE摘要

curl -X POST "http://localhost:8000/summary/boe" \
-H "Content-Type:
application/json" \
-d '{"max_items": 10}'

🏛️ 查询部门

curl -X POST "http://localhost:8000/auxiliary/departments" \
-H "Content-Type: application/json" \
-d '{"search_term": "部", "limit": 10}'

🔢 代码描述

curl "http://localhost:8000/auxiliary/code/7723"

💡 示例

搜索立法

from mcp_boe import BOEHTTPClient
from mcp_boe.tools.legislation import LegislationTools

async def buscar_ley():
    async with BOEHTTPClient() as client:
        tools = LegislationTools(client)
        
        # 搜索《2015年第40号法律》
        resultados = await tools.search_consolidated_legislation({
            "query": "2015年第40号法律",
            "limit": 3
        })
        
        for resultado in resultados:
            print(resultado.text)

获取BOE摘要

from mcp_boe.tools.summaries import SummaryTools
from datetime import datetime, timedelta

async def sumario_boe():
    async with BOEHTTPClient() as client:
        tools = SummaryTools(client)
        
        # 三天前的摘要
        fecha = (datetime.now() - timedelta(days=3)).strftime("%Y%m%d")
        
        resultados = await tools.get_boe_summary({
            "date": fecha,
            "max_items": 5
        })
        
        for resultado in resultados:
            print(resultado.text)

查询部门

from mcp_boe.tools.auxiliary import AuxiliaryTools

async def buscar_departamentos():
    async with BOEHTTPClient() as client:
        tools = AuxiliaryTools(client)
        
        # 搜索部
        resultados = await tools.get_departments_table({
            "search_term": "部",
            "limit": 10
        })
        
        for resultado in resultados:
            print(resultado.text)

🔧 可用工具

📜 已整合立法

工具	描述	参数
`search_consolidated_legislation` 搜索已整合立法。 `query`, `limit`, `offset`
`get_consolidated_law` 获取特定规则。 `law_id`, `include_metadata`, `include_analysis`, `include_full_text`
`get_law_structure` 查看标准结构。 `law_id`

📰 BOE/BORME摘要

工具	描述	参数
`get_boe_summary` 根据日期获取BOE摘要。 `date`, `max_items`
`get_borme_summary` 根据日期获取BORME摘要	`date`, `max_items`
`search_recent_boe` 搜索最近的BOE。 `days_back`, `search_terms`

🏛️ 辅助表格

工具	描述	参数
`get_departments_table` 部门代码。 `search_term`, `limit`
`get_legal_ranges_table`	规范范围	`limit`
`get_code_description` 特定代码描述。 `code`
`search_auxiliary_data` 搜索所有表格	`query`

🧪 测试

# 所有测试
python examples/basic_usage.py all

# 快速测试
python examples/basic_usage.py quick

# 特定测试
python examples/basic_usage.py search
python examples/basic_usage.py summary
python examples/basic_usage.py departments

🤝 贡献

分叉项目
创建新功能分支 (git checkout -b feature/new-feature)
提交更改 (git commit -am '添加新功能')
推送到分支 (git push origin feature/new-feature)
创建Pull Request

本地开发

# 配置开发环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate
pip install -e .

# 运行测试
python -m pytest tests/

# 代码检查
python -m black src/
python -m flake8 src/

📊 项目结构

MCP-BOE/
├── src/mcp_boe/           # 主要源代码
│   ├── models/            # Pydantic模型
│   ├── tools/            # MCP工具
│   ├── utils/            # 实用工具（HTTP客户端）
│   └── server.py         # 主MCP服务器
├── examples/             # 使用示例
├── tests/               # 单元测试
├── pyproject.toml       # 项目配置和依赖
├── rest_api_wrapper.py  # 可选的API REST包装器
└── README.md           # 此文件

🔒 安全

无需认证：BOE API是公开的
速率限制：尊重官方API的限制
官方数据：所有信息直接来自BOE
无存储：数据不进行本地存储

📚 额外文档

🐛 解决问题

错误："没有名为'mcp_boe'的模块"

export PYTHONPATH="${PYTHONPATH}:/路径/到/你的/MCP-BOE/src"

错误："连接被拒绝"

检查与BOE API的连通性：

python examples/basic_usage.py connectivity

错误：Pydantic v2警告

Pydantic v2警告是正常的，不会影响功能。

📝 更新日志

v0.1.0 (2025-08-23)

✅ 初始MCP服务器部署
✅ 支持已整合立法
✅ BOE和BORME摘要
✅ 辅助表格
✅ API REST包装器
✅ 示例和文档

📄 许可证

本项目采用MIT许可证。查看LICENSE文件了解详情。

👤 作者

Victor Viloria

邮箱：vvictor.97@gmail.com
GitHub：@ComputingVictor

🙏 感谢

致官方公报提供公共API
致Anthropic团队的MCP协议
致Python社区提供的优秀库

有任何疑问？ 打开一个问题或提交一个pull request。

喜欢这个项目吗？ 在GitHub上给它一个⭐。