Finlynq 是一款开源（AGPL v3）的个人财务管理应用，内置第一方 MCP 服务器，让你在这里记账、在任何地方分析。
用途： 用于个人财务管理，支持记录和查询收入、支出、预算、投资、贷款、订阅和目标。通过 MCP 服务器，你可以在 Claude、Cursor 或任何 MCP 客户端中查询和管理财务数据。
主要能力：
- 100+ MCP 工具（HTTP 与 stdio）：涵盖账户、交易、预算、目标、贷款、投资组合、订阅、汇率、规则、拆分、批量编辑和文件导入。其中 HTTP 55 个、stdio 89 个。
- 加密：AES-256-GCM 信封加密，scrypt 派生 KEK，按用户密钥加密静态敏感字段。
- 导入：支持 CSV、Excel、OFX/QFX、PDF 导入。
- 财务管理：预算、投资组合、目标、贷款管理。
- AI 对话：自然语言 AI 聊天。
- 计算工具：FIRE 计算器和蒙特卡洛模拟。
- 自动化：规则与自动分类。
- 部署：自托管或托管云。
- 接口：REST API + MCP（HTTP 与 stdio，OAuth 2.1 + DCR）。
- 界面：深色模式，移动端友好。
使用方式： 两种使用方式：托管云或自托管。
- 托管云：访问 finlynq.com/cloud，注册并导入 CSV，无需管理基础设施。公共演示位于 finlynq.com/cloud?demo=1（凭据预填，每晚重置）。连接 Claude 时，将 https://finlynq.com/mcp 粘贴到 Claude → Customize → Connectors。
- 自托管：使用 Docker。首次启动前，创建一个同级的 .env 文件，包含三个密钥（每个用 openssl rand -hex 32 生成）：PF_JWT_SECRET、PF_PEPPER（≥32 字符）、PF_STAGING_KEY（≥32 字符）。如果缺少任何一个，Compose 会快速失败并给出明确消息。然后打开 http://localhost:3000 并注册。应用和 PostgreSQL 运行在 Docker 中；敏感字段使用从账户密码派生的按用户密钥进行静态加密。在将容器暴露给非 localhost 之前，请更改默认 PostgreSQL 密码（.env 中的 POSTGRES_PASSWORD）。完整设置说明见 finlynq.com/self-hosted。
MCP 客户端连接：
- Claude Web / Mobile / Cursor / Windsurf：使用 OAuth 2.1 + 动态客户端注册。将 https://finlynq.com/mcp 粘贴到连接器设置中，无需配置文件。
- Claude Desktop（stdio）：指向 mcp-server/index.ts，并在环境块中设置 PF_USER_ID。
- Bearer API 密钥：在 Settings → API Keys 中生成 pf_* 令牌。适用于 MCP 端点和 /api/ 下的 REST 路由。注意，pf_* 密钥无范围限制，且在重新生成前不会过期，应视为对账户的完全访问；REST 接口是 Web 和移动应用使用的接口，其响应结构不保证稳定性——MCP 是受支持的集成接口。 已提交至 Anthropic Connectors Directory（2026-05-09）。完整的客户端设置、工具目录和经纪对账单配方见 Connect Your AI 指南。
适用场景： 个人财务管理，希望从 AI 客户端查询和管理财务数据的用户，以及希望自托管以保护数据隐私的用户。
限制： AGPL v3 许可。如果你将修改版本作为网络服务运行，需要向用户提供源代码。托管服务 finlynq.com/cloud 运行与此仓库相同的代码。如果你想在 Finlynq 上构建无法承担该义务的产品，可以获取商业许可，见 COMMERCIAL.md。项目采用捐赠制，无付费层级；如果 Finlynq 对你有用，可通过 GitHub Sponsors 或 Ko-fi 支持。
