🚀 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 开发者账户：
- 访问 e-conomic 开发者门户。
- 创建一个新的应用程序并获取以下凭据：
- 客户端 ID
- 客户端秘密
- 使用这些凭据配置 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 许可证。
