欧盟基金数据服务

一个生产就绪的MCP服务器,将斯洛伐克政府的ITMS21+开放数据API暴露为结构化工具,供AI助手使用。

  • by SimonBerg255
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 SimonBerg255/itms21-mcp

使用说明

ITMS21+MCP服务器——斯洛伐克欧盟资金情报层

一个生产就绪的MCP(模型上下文协议)服务器,将斯洛伐克政府的ITMS21+开放数据API公开为运行在内部的人工智能助手的结构化工具 有趣.IMTS21+是斯洛伐克2021-2027规划期间管理欧盟结构基金的官方信息系统。所有数据都是官方的、公开的,不需要身份验证。

先决条件

  • Python 3.11+
  • 网络访问 api.itms21.sk

设置

# Clone / copy this directory
cd itms21-mcp

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Generate .env with a random secret
python3 -c "import secrets; print('MCP_SERVER_JWT_SECRET=' + secrets.token_hex(32))" > .env
echo "MCP_SERVER_JWT_ISSUER=itms21-mcp" >> .env
echo "MCP_SERVER_JWT_AUDIENCE=intric" >> .env

# Verify all tools work
python3 test_tools.py

运行服务器

uvicorn server:app --host 0.0.0.0 --port 8000

服务器将在以下时间可用 http://localhost:8000/mcp. 健康检查: http://localhost:8000/health

连接到Intric

  1. 生成JWT令牌: python3 generate_token.py
  2. 在Intric中,请访问 管理员→ MCP服务器→ 添加服务器
  3. 服务器URL: http://YOUR_SERVER_IP:8000/sse
  4. API密钥: 粘贴生成的JWT令牌
  5. 保存并测试连接
  6. 所有8个工具都将自动出现在您的Intric助手中

提示: 使用ngrok公开HTTPS URL: ngrok http 8000

可用工具

工具 说明
search_open_calls 查找当前开放的欧盟资助电话(výzvy)
get_call_detail 获取特定通话的完整细节,包括条件和指标
search_planned_calls 查找尚未开始准备的来电
search_approved_applications 查找已批准的拨款申请作为参考示例
get_application_detail 阅读已批准申请的全文(说明、预算、指标)
search_projects 查找目前正在实施的资助项目
get_project_detail 获取活动、指标和预算的完整项目详细信息
get_programme_structure 获取欧盟计划层次结构(计划→ 优先事项→ 具体目标)

项目结构

itms21-mcp/
├── server.py           # FastMCP server — Intric boilerplate + tool registration
├── tools_itms.py       # All 8 ITMS21+ tool implementations
├── itms_client.py      # HTTP client for api.itms21.sk
├── test_tools.py       # Verification runner — must exit 0
├── generate_token.py   # JWT token generator for Intric
├── requirements.txt    # Python dependencies
├── .env.example        # Environment variable template
└── README.md           # This file

API文档

  • ITMS21+API:https://api.itms21.sk/public/v1/
  • 官方文件:https://eurofondy.gov.sk/dokumenty-a-publikacie/metodicke-dokumenty/dokumenty-itms21/