MCP Economic

🚀 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"
)

⚙️ 設定

インストールが完了したら、必要に応じて以下の設定を行うことができます。

ログ記録の設定

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 応答を返します。

• 成功/エラーのステータス
• 関連データまたはエラー詳細
• ページング情報（適用される場合）
• 追加のコンテキストとメタデータ

すべてのツールでエラー処理が統一されており、詳細なエラーメッセージと問題解決の提案が提供されます。