使用说明
OpenFisca MCP
用于与OpenFisca税收优惠系统交互的MCP（模型上下文协议）工具。
安装
poetry install
用法
启动OpenFisca服务器
./scripts/serve.sh
运行MCP服务器
poetry run openfisca-mcp
使用Claude Desktop进行配置
添加到您的Claude Desktop配置中：
{
"mcpServers": {
"openfisca": {
"command": "poetry",
"args": ["run", "openfisca-mcp"],
"cwd": "/path/to/RaMCP"
}
}
}
可用工具
| 工具 | 说明 |
|---|---|
list_entities |
列出实体类型（人、家庭）及其角色 |
list_variables |
列出所有可用变量，可选择按实体筛选 |
describe_variable |
获取详细的变量信息（类型、期间、公式） |
list_parameters |
列出所有参数（费率、阈值、金额） |
get_parameter |
获取参数值和历史记录 |
search_variables |
按关键字搜索变量 |
calculate |
计算一种情况的变量值 |
trace_calculation |
使用依赖关系跟踪进行计算以获得可解释性 |
validate_situation |
无需计算即可验证情况结构 |
发展
运行测试
poetry run pytest
生成金色固定装置
./scripts/serve.sh &
poetry run python tests/generate_golden.py
┌────────────────────┬───────┬───────────────────────────────────────────────────────────────────────────────────────────┐ │ 包裹│ 测试│ 主要发现│ ├────────────────────┼───────┼───────────────────────────────────────────────────────────────────────────────────────────┤ │ 法国openfisa│ 14 ✅ │ 4 实体，年龄的月份周期，情况下需要的所有4个实体│ ├────────────────────┼───────┼───────────────────────────────────────────────────────────────────────────────────────────┤ │ 奥特亚罗瓦│ 17 ✅ │ 5 实体（包括财产实体）、年龄的DAY期、允许的最小情况│ └────────────────────┴───────┴───────────────────────────────────────────────────────────────────────────────────────────┘
