freee会计MCP服务

freee会计MCP服务是一个与freee会计API集成的Model Context Protocol (MCP)服务器,旨在通过AI助手辅助会计业务。它提供了丰富的会计数据访问功能,包括事业所信息、勘定科目、取引数据等的获取与管理,以及OAuth 2.0认证、取引管理、系统监控等工具。

  • by tsurutan
  • 1 星标
  • 更新于
在 GitHub 查看 tsurutan/freee-accounting-mcp

使用说明

freee会计MCP服务

产品定位

freee会计MCP服务是一个非官方的MCP服务器,旨在通过AI助手辅助会计业务,提供与freee会计API的集成能力。

核心功能

资源管理

  • 事业所信息的获取
  • 勘定科目列表的获取
  • 取引先信息的获取
  • 部门信息的获取
  • 品目信息的获取
  • メモタグ信息的获取
  • 取引数据的获取
  • 试算表数据的获取

工具

  • 认证管理(生成认证URL、交换认证代码、检查认证状态)
  • 连接测试
  • 取引管理(创建、更新、获取取引)
  • 取引先的创建
  • 勘定科目的创建
  • 系统监控(获取速率限制信息、获取日志、获取指标、获取健康状态)
  • 缓存管理(获取缓存统计、清除缓存)

提示

  • 设置指南
  • 取引入力支援
  • 月度结算检查清单
  • 试算表分析指南

适用场景

  • 会计数据的自动化处理
  • 财务报告的生成与分析
  • 取引数据的批量管理
  • 会计业务的AI辅助

使用教程

依赖安装

# 确保已安装Node.js 18.0.0以上和npm 9.0.0以上
node -v
npm -v

安装步骤

# 安装依赖
npm install

# 开发模式构建
npm run dev

# 生产模式构建
npm run build

环境变量设置

创建.env文件并设置以下环境变量:

FREEE_CLIENT_ID=your_client_id
FREEE_CLIENT_SECRET=your_client_secret
FREEE_API_BASE_URL=https://api.freee.co.jp

调试方式

# 开发模式调试
npm run debug

# 检查认证状态
check-auth-status

# 获取事业所列表
companies://list

# 获取取引列表
get-deals