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 許可證。