MCP 经济整合

这是 e-conomic 的模型上下文协议 (MCP) 服务器实现。它为 MCP 协议和 e-conomic API 提供了桥梁，允许通过 Claude Desktop 标准化访问 e-conomic 的会计和业务功能。

特性

• 强大的身份验证：使用 APP_SECRET_TOKEN 和 AGREEMENT_GRANT_TOKEN 进行安全的基于令牌的身份验证
• 全面的财务管理：
  • 帐户目录访问，带过滤和分类功能
  • 发票生命周期管理（草稿、已记录、已付、未付）
  • 客户和供应商关系管理
  • 分录创建和管理

目录

• 先决条件
• 安装
• 配置您的 e-conomic 开发者账户
• 配置
• 安全
• 可用的 MCP 命令

先决条件

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

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

安装

要安装 MCP 经济整合，请按照以下步骤操作：

使用 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"
)

配置

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

设置日志记录

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 响应，包括：

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

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