Surefinance MCP Server

SureFinance MCP 服务器

SureFinance金融数据集成的模型上下文协议（MCP）服务器。

概述

此MCP服务器通过标准化工具和资源，提供对SureFinance财务数据的程序化访问。它使AI助手和其他MCP客户端能够查询账户、交易、预算和分析数据。

技术栈

• 语言： Ruby 3.4.4
• MCP SDK：（可译为）MCP软件开发工具包 官方Ruby SDK
• 交通： HTTP/HTTPS（超文本传输协议/超文本传输安全协议）
• 数据库： PostgreSQL（与SureFinance Rails应用共享）

项目结构

surefinance-mcp-server/
├── lib/
│   ├── surefinance_mcp/
│   │   ├── server.rb        # Main MCP server
│   │   ├── tools/           # MCP tool implementations
│   │   ├── resources/       # MCP resource handlers
│   │   └── models/          # Data models
│   └── surefinance_mcp.rb   # Main entry point
├── config/
│   ├── database.yml         # Database configuration
│   └── server.yml           # Server configuration
├── Gemfile
├── Dockerfile
├── docker-compose.yml
└── README.md

快速入门

# Install dependencies
bundle install

# Set up environment
cp .env.example .env
# Edit .env with your configuration

# Run the server
bundle exec ruby lib/surefinance_mcp.rb

Docker 部署

# Build and run with Docker Compose
docker compose up --build -d

# View logs
docker compose logs -f surefinance-mcp

环境

服务器使用 .env 用于配置。审查 .env.example 对于可用的选项，包括服务器主机/端口、数据库连接、认证密钥和日志记录。

MCP表面积

工具

• get_accounts — 列出所有当前有余额的账户
• get_account_balance_history — 提供余额历史记录以用于绘图
• get_transactions — 查询交易，可选过滤器
• search_transactions — 在交易中执行关键词搜索
• get_budgets — 提交包含期间分析的预算
• get_categories — 列出类别和层级结构

资源

• surefinance://accounts/{id} — 账户详情和余额历史
• surefinance://transactions/{id} — 交易详情
• surefinance://budgets/{id} — 预算详情和支出明细
• surefinance://holdings/{id} — 投资控股详情

认证

服务器支持通过以下方式进行身份验证：

• API密钥（针对可信任的客户端）
• JWT令牌（用于程序化访问）

看见 认证指南 详情请见。

发展

# Run tests
bundle exec rspec

# Run linter
bundle exec rubocop

# Auto-fix linting issues
bundle exec rubocop -a

文档

完整的文档可在以下位置获取： BookStack（书籍堆栈/书籍库）。

相关项目

• SureFinance（可译为“确信金融”或根据具体语境调整为更贴切的名称，但直接音译“苏尔金融”也是可行的） - 个人理财与财富管理应用程序
• “Huly Project”可以翻译为“胡利项目”或根据具体语境可能需要意译为更贴切的名称，但直接翻译就是“胡利项目”。如果“Huly”是特定人名、地名或专有名词，且没有官方或广泛接受的中文译名，那么“胡利”就是其直接对应的中文翻译 - 项目跟踪

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件