# beancount_mcp

**Repository Path**: Abreto/beancount_mcp

## Basic Information

- **Project Name**: beancount_mcp
- **Description**: 注于将MCP应用于Beancount账本管理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-04-14
- **Last Updated**: 2025-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Beancount MCP 项目说明

## 项目简介
Model Context Protocol (MCP) 是一个开放协议，旨在实现LLM应用与外部数据源和工具之间的无缝集成。该项目专注于将MCP应用于Beancount账本管理，使得多种大型语言模型（如GPT-4、DeepSeek V3、Claude 3.7、Gemini-2.5 Pro）能够有效操作Beancount账本。

## 项目目标
本项目的终极目标是利用LLM技术帮助小微企业实现代理记账和报税功能。目前，报税功能的MCP正在积极开发中。

## 功能概述
- **账本管理**：通过MCP协议，LLM可以读取和操作Beancount账本数据。
- **智能分析**：利用LLM的强大分析能力，提供账本数据的智能分析和报告生成。
- **自动化流程**：简化小微企业的记账流程，提高效率。
- **模型能力提示**：记账的水平取决于模型能力，目前来看GPT-4o和Gemini-2.5 Pro表现优异。本项目团队后续考虑自行微调一个模型以进一步提升性能。

## 开发计划(TODO)
- [ ] 导出三张表功能(资产负债表、利润表、现金流量表)正在开发中
- [ ] 银企对账功能开发（支持主流银行对账单导入和自动核对）
- [ ] 报税功能开发

## 使用说明
1. 下载本仓库文件。
2. 在支持MCP的chatbot中，将以下配置复制进去即可使用。请将路径 `C:\\code\\beancount_mcp` 修改为您的下载路径：
   ```json
   {
     "mcpServers": {
       "beancount": {
         "autoApprove": [
           "list_tools"
         ],
         "disabled": false,
         "timeout": 60,
         "command": "uv",
         "args": [
           "--directory",
           "C:\\code\\beancount_mcp",
           "run",
           "accounting_mcp.py"
         ],
         "transportType": "stdio"
       }
     }
   }

## 联系方式
欢迎扫描项目中的二维码加入MCP交流群，与其他用户交流使用经验，获取最新项目动态和技术支持。
![微信](wechat.png)