# da_mcp_server

**Repository Path**: elfbobo_admin_admin/da_mcp_server

## Basic Information

- **Project Name**: da_mcp_server
- **Description**: 晨舟财务作为新一代财务会计软件，设计之初就面向接入人工智能大模型，后端接口包括全部业务校验，前端和大模型处在相同的设计位置，前端有人操控，而mcp服务则是由大模型代理操控。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.shrycode.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-09
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# da_mcp_server

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![MCP Version](https://img.shields.io/badge/MCP-2024%2B%2B-orange.svg)](https://modelcontextprotocol.io/)

晨舟财务会计软件 MCP (Model Context Protocol) 服务器，为 Claude 等大语言模型提供财务会计操作的标准化接口。

## 🌟 特性

- **完整财务模块支持**：凭证管理、账簿管理、基础数据、资产管理、现金管理
- **标准化协议**：基于 MCP 协议，提供统一的工具调用接口
- **易于集成**：可快速接入支持 MCP 的 AI 应用
- **类型安全**：使用 Pydantic 进行数据验证和类型检查
- **高性能**：异步请求处理，支持缓存优化

## 📋 系统要求

- Python 3.8 或更高版本
- 晨舟财务会计软件（Windows 版本）
- 8GB RAM 或更高（推荐 16GB）

## 🚀 快速开始

### 安装

1. **克隆仓库**
```bash
git clone https://gitee.com/jlmpp/da_mcp_server.git
cd da_mcp_server
```

2. **安装依赖**
```bash
pip install -r requirements.txt
```

3. **配置服务**
编辑 `config.py` 文件，设置您的晨舟财务软件连接参数：
```python
config = {
    "service_url": "http://localhost:8080",  # 晨舟财务 API 地址
    "timeout": 30,                          # 请求超时时间（秒）
    "cache_ttl": 300,                       # 缓存有效期（秒）
}
```

### 运行服务器

```bash
# 开发模式运行
python server.py

# 或使用 MCP 客户端连接
mcp connect python server.py
```

### 连接到 Claude Desktop

在 Claude Desktop 的配置文件中添加：

```json
{
  "mcpServers": {
    "da_mcp_server": {
      "command": "python",
      "args": ["/path/to/da_mcp_server/server.py"],
      "env": {
        "PYTHONPATH": "/path/to/da_mcp_server"
      }
    }
  }
}
```

## 📚 功能模块

### 🔧 设置模块 (Settings)
- 会计账簿管理
- 会计期间配置
- 用户权限设置

### 📝 基础数据模块 (Basic Data)
- 会计科目管理
- 科目体系配置
- 辅助核算项目

### 💰 凭证管理模块 (Voucher Management)
- 凭证录入与修改
- 凭证查询与筛选
- 凭证审核与过账
- 凭证批量导入

### 📊 账簿管理模块 (Ledger Management)
- 总账查询
- 明细账查询
- 科目余额表
- 试算平衡表

### 🏦 现金管理模块 (Cashier)
- 现金日记账
- 银行日记账
- 资金流水查询
- 银行对账

### 🏢 资产管理模块 (Asset Management)
- 固定资产卡片
- 资产折旧计算
- 资产变动记录
- 折旧费用分配

## 🛠️ 可用工具

### 会计设置
- `configure_services` - 配置财务服务连接
- `accounting_book_list` - 获取会计账簿列表
- `accounting_standard_all` - 获取会计准则列表

### 科目管理
- `accounting_title_list` - 获取会计科目列表
- `accounting_title_update` - 更新会计科目
- `accounting_title_category_list` - 获取科目类别列表

### 辅助核算
- `auxiliary_accounting_category_list` - 获取辅助核算类别
- `auxiliary_accounting_list` - 获取辅助核算项目
- `auxiliary_accounting_batch_create` - 批量创建辅助核算项目

### 凭证操作
- `voucher_create` - 创建记账凭证
- `voucher_batch_create` - 批量创建凭证
- `get_voucher_list` - 获取凭证列表
- `generate_voucher_number` - 生成凭证号

### 账簿查询
- `get_trial_bal` - 获取试算平衡表
- `get_home_statistic` - 获取首页统计数据

### 报表功能
- `report_list` - 获取财务报表列表
- `balance_sheet_formula_list` - 资产负债表公式
- `profit_statement_formula_list` - 利润表公式
- `calculation_formula_batch_create` - 批量创建计算公式

## 🔌 API 示例

### 创建凭证

```python
# 通过 MCP 工具创建凭证
result = await mcp.call_tool("voucher_create", {
    "accounting_book_id": "book_001",
    "voucher_date": "2024-01-15",
    "voucher_type": "记账凭证",
    "entries": [
        {
            "account_title_id": "1001",
            "debit_amount": 10000.00,
            "credit_amount": 0.00,
            "description": "收到投资款"
        },
        {
            "account_title_id": "3001",
            "debit_amount": 0.00,
            "credit_amount": 10000.00,
            "description": "实收资本"
        }
    ]
})
```

### 查询科目余额

```python
# 获取科目余额表
balance = await mcp.call_tool("get_trial_bal", {
    "accounting_book_id": "book_001",
    "period": "2024-01",
    "account_title_id": "1001"
})
```

## 🏗️ 开发

### 项目结构

```
da_mcp_server/
├── server.py              # 主服务器入口
├── config.py              # 配置文件
├── logging_config.py      # 日志配置
├── requirements.txt       # Python 依赖
├── __init__.py           # 版本信息
├── settings/             # 设置模块
├── basic_data/           # 基础数据模块
├── voucher_mgmt/         # 凭证管理模块
├── ledger_mgmt/          # 账簿管理模块
├── cashier/              # 现金管理模块
├── assets/               # 资产管理模块
├── home_statistic/       # 统计模块
└── file_manager/         # 文件管理模块
```

### 添加新模块

1. 创建模块目录和 `__init__.py`
2. 创建 `__main__.py` 文件定义工具
3. 在 `server.py` 中导入并注册新模块

```python
# 示例：添加新模块
try:
    from new_module.__main__ import register_new_module_tools
    register_new_module_tools(mcp)
except ImportError as e:
    logger.error(f"导入新模块失败: {e}")
```

### 构建可执行文件

```bash
# 使用 PyInstaller 打包
pyinstaller da_mcp_server.spec

# 生成的可执行文件在 dist/ 目录下
```

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目基于 MIT 许可证开源 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🔗 相关链接

- [晨舟财务官网](https://www.example.com)
- [Model Context Protocol 官网](https://modelcontextprotocol.io/)
- [Claude API 文档](https://docs.anthropic.com/claude)

## 📞 支持

如遇问题，请：

1. 查看 [Issues](https://github.com/yourusername/da_mcp_server/issues) 页面
2. 创建新的 Issue 描述问题
3. 联系技术支持：support@example.com

## 🎯 路线图

- [ ] 支持更多财务软件版本
- [ ] 增加预算管理模块
- [ ] 支持多币种核算
- [ ] 添加工作流审批功能
- [ ] 支持批量导入导出
- [ ] 集成 OCR 票据识别

---

**注意**：本服务器需要与晨舟财务会计软件配合使用。请确保已正确安装并配置晨舟财务软件。