Toshl MCP Server

基本能力

产品定位

Toshl MCP Server 是一个金融服务工具，旨在通过 MCP 协议将 Toshl Finance 的财务数据与 AI 代理集成，提供财务数据访问和分析能力。

核心功能

• 数据访问：提供对 Toshl Finance API 的读取访问，包括账户、类别、标签、预算、用户信息和计划等。
• MCP 资源：支持列出和获取账户、类别、标签、预算、用户信息和条目等详细信息。
• MCP 工具：
• 账户工具（列出账户、获取账户详情）
• 类别工具（列出类别、获取类别详情）
• 标签工具（列出标签、获取标签详情）
• 预算工具（列出预算、获取预算详情、获取预算历史）
• 用户工具（获取个人资料、获取摘要、获取付款类型、获取付款）
• 条目工具（列出条目、获取条目详情、获取条目总和、获取条目时间线、创建条目、更新条目、删除条目、管理条目）
• 分析工具（按类别分析支出、分析预算表现、分析账户余额）

适用场景

• 财务分析：AI 代理可以通过该服务器获取用户的财务数据，进行支出分析和预算表现分析。
• 自动化财务管理：自动化工具可以通过该服务器管理用户的财务条目，如创建、更新或删除条目。
• 个性化建议：基于用户的财务数据，AI 代理可以提供个性化的财务建议和规划。

使用教程

使用依赖

• Node.js (v18.x 或更高版本)
• npm (v8.x 或更高版本)
• Toshl Finance API 令牌

获取 API 令牌

1. 访问 https://developer.toshl.com/apps/
2. 创建新的个人令牌，在“Description”下输入令牌名称，在“Password”下输入您的账户密码。

安装教程

1. 克隆仓库：

git clone https://github.com/yourusername/toshl-mcp-server.git
cd toshl-mcp-server

1. 安装依赖：

npm install

1. 创建 .env 文件：

cp .env.example .env

1. 编辑 .env 文件并添加您的 Toshl API 令牌：

TOSHL_API_TOKEN=your_api_token

构建项目

npm run build

运行服务器

npm start

配置 MCP 服务器

"toshl-mcp-server": {
  "command": "node",
  "args": [
    "/root/source/personal/toshl-mcp-server/dist/index.js"
  ],
  "env": {
    "TOSHL_API_TOKEN": "your-token",
    "TOSHL_API_BASE_URL": "https://api.toshl.com",
    "MCP_SERVER_NAME": "toshl-mcp-server",
    "MCP_SERVER_VERSION": "0.1.0",
    "CACHE_TTL": "3600",
    "CACHE_ENABLED": "true",
    "LOG_LEVEL": "debug"
  },
  "disabled": false,
  "autoApprove": []
}

开发模式

npm run dev

调试方式

• 检查日志级别设置为 debug 以获取详细日志信息。
• 确保 .env 文件中的 TOSHL_API_TOKEN 正确配置。
• 使用 npm run dev 在开发模式下运行服务器，便于实时调试。

许可证

该项目遵循 MIT 开源许可条款。