MCP Economic

🚀 MCP 经济整合

这是一款基于 e-conomic 的模型上下文协议 (MCP) 服务器实现，它搭建起了 MCP 协议与 e-conomic API 之间的桥梁，借助 Claude Desktop 实现对 e-conomic 会计及业务功能的标准化访问。

✨ 主要特性

• 强大的身份验证：借助 APP_SECRET_TOKEN 和 AGREEMENT_GRANT_TOKEN，实现安全的基于令牌的身份验证。
• 全面的财务管理：
  • 支持帐户目录访问，具备过滤和分类功能。
  • 可进行发票生命周期管理，涵盖草稿、已记录、已付、未付等状态。
  • 能够管理客户和供应商关系。
  • 支持分录创建和管理。

📦 安装指南

先决条件

在开始安装前，请确保满足以下要求：

• 已安装 Python 3.12.2 或更高版本。
• 使用 macOS、Linux 或 Windows 操作系统。
• 已安装依赖项管理工具（如 pip）。

安装步骤

使用 pip 安装

pip install mcp-economic-integration

从源代码安装

git clone https://github.com/your-organization/mcp-economic-integration.git
cd mcp-economic-integration
python setup.py install

📚 详细文档

配置您的 e-conomic 开发者账户

要使用 MCP 经济整合，您需要先配置您的 e-conomic 开发者账户：

1. 访问 e-conomic 开发者门户。
2. 创建一个新的应用程序并获取以下凭据：
   • 客户端 ID
   • 客户端秘密
3. 使用这些凭据配置 MCP 经济整合库。

示例配置

from mcp_economic_integration import configure

configure(
    client_id="your_client_id",
    client_secret="your_client_secret"
)

配置

完成安装后，您可以根据需要进行以下配置：

设置日志记录

import logging

logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)
logger = logging.getLogger(__name__)

设置代理（可选）

如果您需要通过代理访问 e-conomic 服务，请配置以下环境变量：

export HTTP_PROXY=http://your-proxy-server:port
export HTTPS_PROXY=https://your-proxy-server:port

安全

请注意以下安全最佳实践：

• 不要在生产环境中运行此代码。
• 保护好您的凭据，避免泄露。
• 定期更新依赖项，以防止已知漏洞。

可用的 MCP 命令

MCP 经济整合提供了以下工具，按类别组织如下：

账户管理

• get_accounts：获取账户目录中的账户列表，带过滤选项：
  • 按类型筛选（损益、状态、总金额从、标题等）。
  • 按阻止状态筛选。
  • 按借方/贷方类型筛选。
  • 按阻止直接记账状态筛选。
• get_account：按账户编号获取特定账户的详细信息。

发票管理

• get_booked_invoices：获取所有已记录（最终）发票。
• get_draft_invoices：获取所有草稿（未最终）发票。
• get_paid_invoices：获取所有已付发票。
• get_unpaid_invoices：获取所有未付发票。
• get_invoice_totals：获取所有发票的摘要总计。
• create_draft_invoice：创建新的草稿发票，带详细的客户和支付信息。

分录管理

• create_supplier_invoice_entry：创建供应商发票分录。
• create_supplier_payment_entry：创建供应商付款分录。
• create_customer_payment_entry：创建客户付款分录。
• create_customer_invoice_entry：创建客户发票分录。

供应商管理

• get_suppliers：获取所有供应商的列表。
• get_supplier_groups：获取所有供应商组。

客户管理

• get_customers：获取所有客户的列表。
• get_customer_totals：获取特定客户的账户总计。
• get_customer_groups：获取所有客户组。

每个工具返回一个标准化的 JSON 响应，包括：

• 成功/错误状态。
• 相关数据或错误详细信息。
• 分页信息（如适用）。
• 额外上下文和元数据。

错误处理在所有工具中保持一致，提供详细的错误消息和解决问题的建议。

📄 许可证

本项目采用 MIT 许可证。