Erpnext

🚀 ERPNext MCP サーバー

ERPNext の統合に使用されるモデルコンテキストプロトコル (Model Context Protocol) サーバーです。

このサーバーは TypeScript で構築され、ERPNext/Frappe API との統合機能を提供します。AI アシスタントがモデルコンテキストプロトコルを通じて ERPNext のデータと機能にアクセスできるようにします。

✨ 主な機能

リソース

• erpnext://{doctype}/{name} URI を通じて ERPNext ドキュメントにアクセス
• JSON 形式を使用した構造化データアクセス

ツール

• authenticate_erpnext - ユーザー名とパスワードを使用して ERPNext を認証
• get_documents - 特定のドキュメントタイプのドキュメントリストを取得
• create_document - ERPNext で新しいドキュメントを作成
• update_document - 既存のドキュメントを更新
• run_report - ERPNext レポートを実行
• get_doctype_fields - 特定のドキュメントタイプのフィールドリストを取得
• get_doctypes - すべての利用可能なドキュメントタイプのリストを取得

📦 インストール

環境変数の設定

サーバーには以下の環境変数が必要です。

• ERPNEXT_URL - あなたの ERPNext インスタンスのベース URL
• ERPNEXT_API_KEY (オプション) - API アクセスキー
• ERPNEXT_API_SECRET (オプション) - API パスワード

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築付きの開発

npm run watch

クラウドデスクトップとの使用

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

以下のように設定します。

{
  "mcpServers": {
    "erpnext": {
      "command": "node",
      "args": ["/path/to/erpnext-server/build/index.js"],
      "env": {
        "ERPNEXT_URL": "http://your-erpnext-instance.com",
        "ERPNEXT_API_KEY": "your-api-key",
        "ERPNEXT_API_SECRET": "your-api-secret"
      }
    }
  }
}

VSCode 内のクラウドとの使用

• MacOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

デバッグ

MCP サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP Inspector をおすすめします。このツールはパッケージスクリプトで実行できます。

npm run inspector

Inspector はブラウザでアクセスできるデバッグツールの URL を提供します。

💻 使用例

認証

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>authenticate_erpnext</tool_name>
<arguments>
{
  "username": "your-username",
  "password": "your-password"
}
</arguments>
</use_mcp_tool>

顧客リストの取得

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_documents</tool_name>
<arguments>
{
  "doctype": "Customer"
}
</arguments>
</use_mcp_tool>

ドキュメントの作成

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>create_document</tool_name>
<arguments>
{
  "doctype": "Sales Invoice",
  "data": {
    "customer": "Test Customer",
    "amount": 100
  }
}
</arguments>
</use_mcp_tool>

ドキュメントの更新

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name:update_document>
{
  "doctype": "Sales Invoice",
  "name": "INV-001",
  "data": {
    "amount": 200
  }
}
</arguments>
</use_mcp_tool>

レポートの実行

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>run_report</tool_name>
<arguments>
{
  "report": "Sales Report",
  "filters": {
    "from_date": "2023-01-01",
    "to_date": "2023-12-31"
  }
}
</arguments>
</use_mcp_tool>

ドキュメントタイプのフィールド取得

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_doctype_fields</tool_name>
<arguments>
{
  "doctype": "Sales Invoice"
}
</arguments>
</use_mcp_tool>

すべてのドキュメントタイプの取得

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_doctypes</tool_name>
</use_mcp_tool>