AI导哈

金融分析服务

FinPilot MCP Server 是一个提供金融分析能力的服务，通过 Model Context Protocol 实现，支持 Claude Desktop 和 VS Code 的本地集成，提供无配置访客模式和完整个人财务工具的认证模式。

  • by coolksrini
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 coolksrini/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://<auth-service>.run.app",
        "FINPILOT_API_KEY": "fp_your_token_here"
      }
    }
  }
}

编辑后重新启动Claude Desktop。

环境变量

变量 默认值 描述
FINPILOT_GATEWAY_URL http://localhost:8080 身份验证服务URL
FINPILOT_API_KEY （无） API密钥(fp_...).省略客人模式。

命令行用法

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

# Authenticated mode
FINPILOT_GATEWAY_URL=https://<auth-service>.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许可证

相关 MCP