FI-MCP
金融独立社区的模型上下文协议（MCP）服务器。
概述
FI-MCP使用自检从FI函数库自动生成MCP工具。 这允许AI助手访问我们的财务独立计算功能 作为原生工具使用。这通过确保AI使用 为工作进行正确的计算，而不是猜测或随机计算 网络。它还增强了用户的信心，因为它让我们知道在哪里 计算来自。数学可以在 FI图书馆 以及相关的博客文章或论坛链接（如适用）。
特性
- 自动发现：自动查找FI库中的所有函数
- 类型安全：将Python类型注释转换为MCP工具模式
- 参数验证：在函数调用之前验证和转换参数
- 全面覆盖：所有30+FI功能均可作为MCP工具使用
安装
发展：
# Clone the repository
cd /path/to/FI-MCP
# Install package with dev dependencies in editable mode
pip install -e .[dev]用于生产用途：
pip install .AI编辑器的配置
将这些设置添加到您的Windsurf MCP配置文件中，Claude ~/.claude/config.json, 或其他类似文件：
{
"mcpServers": {
"fi-mcp": {
"command": "python",
"args": ["-m", "fi_mcp.server"],
"env": {
"PYTHONUNBUFFERED": "1"
}
}
}
}添加配置后，重新启动编辑器。AI助手现在将拥有 访问所有FI计算工具。
用法
配置后，您可以向AI助手提出以下问题：
- “计算我的CoastFI号码，投资5万美元，回报率4%，65岁退休，目前为30岁”
- “每年花4万美元买一天的自由要花多少钱？”
- “我如何计算上限率？”-获取完整的文档，包括它的计算内容、参数和积分
- “我不记得如何计算周转成本”-获取完整的文档，包括计算内容、参数和信用
- “future_value接受哪些输入？”-查看所有带描述的参数
- “显示所有可用的FI计算”-浏览所有可用功能
AI将自动使用适当的FI工具进行FI相关计算。 它可以访问任何函数的完整markdown格式的文档字符串，包括详细的 解释、参数描述、返回值和归因积分。
可用工具
看 FI图书馆 查看可用工具的完整列表。
建筑
FI-MCP使用内省模式来：
- 发现FI模块中的所有功能
- 从函数签名和markdown文档字符串中提取参数类型和描述
- 自动生成MCP工具模式
- 通过MCP资源公开功能文档
- 句柄类型转换和验证
- 使用转换后的参数执行函数
MCP功能
- 工具：每个FI功能都作为MCP工具公开，具有完整的类型信息和参数描述
- 资源：功能文档可通过以下方式获得
fi://help/{function_name}URI，返回markdown格式的文档字符串
发展
设置
在可编辑模式下安装带有开发依赖项的软件包：
pip install -e .[dev]运行测试
运行所有测试：
pytest -v运行特定测试文件：
pytest tests/test_docstring_validation.py -v
pytest tests/test_basic.py -v测试覆盖率
tests/test_docstring_validation.py-验证所有FI函数是否具有正确的markdown文档字符串tests/test_basic.py-功能发现、模式生成和执行的集成测试
许可证
MIT许可证-与FI库相同