Finpilot MCP

FinPilot MCP服务器

Claude Desktop和VS Code的人工智能金融联合试点

MCP服务器通过模型上下文协议提供财务分析功能。 请求通过FinPilot身份验证服务流动，该服务验证凭据和路由 到私人编排。

特性

• 与Claude Desktop和VS Code的原生集成
• 零配置访客模式——无状态计算工具无需帐户即可工作
• 认证模式——完整的个人理财工具（信用报告、投资组合、LAMF）
• 云端分析（无需本地计算）

Claude桌面设置

编辑Claude桌面配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

零配置（访客模式——仅限无状态工具）

不需要帐户或API密钥。无状态计算工具（贷款优化器、APR 计算机等）开箱即用。个人理财工具（信用报告分析， 投资组合）需要登录。

{
  "mcpServers": {
    "finpilot": {
      "command": "uv",
      "args": ["run", "finpilot-mcp"]
    }
  }
}

已验证（完全访问）

生成一个 fp_ API密钥来自 myfinpilot.io → 设置→ API令牌，然后将其添加到此处：

{
  "mcpServers": {
    "finpilot": {
      "command": "uv",
      "args": ["run", "finpilot-mcp"],
      "env": {
        "FINPILOT_GATEWAY_URL": "https://.run.app",
        "FINPILOT_API_KEY": "fp_your_token_here"
      }
    }
  }
}

编辑后重新启动Claude Desktop。

环境变量

命令行用法

# Guest mode (zero-config)
uv run finpilot-mcp

# Authenticated mode
FINPILOT_GATEWAY_URL=https://.run.app \
FINPILOT_API_KEY=fp_your_token_here \
uv run finpilot-mcp

# HTTP mode (for local testing)
uv run finpilot-mcp --mode http --port 8002

CLI选项：

• --mode --运输方式： stdio （默认）或 http
• --host --HTTP服务器主机（默认值：0.0.0.0）
• --port --HTTP服务器端口（默认值：8002）
• --reload --启用自动重新加载以进行开发

可用工具

信用分析

• analyze_credit_report --分析CIBIL/Experian/Equifax报告
• get_credit_health --信用状况摘要

投资组合分析

• analyze_portfolio -分析CAS报表或投资组合数据

贷款优化

• optimize_loans --LAMF和再融资建议

财务规划

• create_financial_plan --基于目标的财务规划

建筑

┌─────────────────────────────────────┐
│  Claude Desktop / VS Code           │
└────────────┬────────────────────────┘
             │ MCP Protocol (STDIO)
             ▼
┌─────────────────────────────────────┐
│  finpilot-mcp (This Package)        │
│  - Lightweight MCP wrapper          │
│  - Optional FINPILOT_API_KEY auth   │
│  - No business logic                │
└────────────┬────────────────────────┘
             │ HTTPS + optional Bearer token
             ▼
┌─────────────────────────────────────┐
│  Auth Service (Public entry point)  │
│  - Token validation / guest assign  │
│  - In-process rate limiting         │
│  - Injects X-User-* headers         │
└────────────┬────────────────────────┘
             │ SA identity token (private)
             ▼
┌─────────────────────────────────────┐
│  Orchestrator (Private Cloud Run)   │
│  - Multi-agent ADK orchestration    │
│  - Business logic & algorithms      │
└─────────────────────────────────────┘

发展

# Install dependencies
cd backend/finpilot-mcp
uv sync

# Run in HTTP mode for local testing
FINPILOT_GATEWAY_URL=http://localhost:8080 \
uv run finpilot-mcp --mode http --port 8002

# Run tests
uv run pytest

安全

• 所有API通过HTTPS通信
• 仅通过环境变量的API密钥
• 本地未存储敏感数据
• CLI参数或代码中永远不会有秘密

许可证

MIT许可证