ERPNext MCP サーバー

ERPNext統合のためのモデルコンテキストプロトコルサーバー

これはTypeScriptベースのMCPサーバーであり、ERPNext/Frappe APIとの統合を提供します。これにより、AIアシスタントはモデルコンテキストプロトコルを介してERPNextのデータや機能とやり取りできるようになります。

特徴

リソース

erpnext://{doctype}/{name} URI 経由で ERPNext ドキュメントにアクセスします。
構造化データアクセスのためのJSON形式

ツール

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

Related MCP server: Lodestar MCP Server

構成

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

ERPNEXT_URL - ERPNextインスタンスのベースURL
ERPNEXT_API_KEY (オプション) - 認証用のAPIキー
ERPNEXT_API_SECRET (オプション) - 認証用のAPIシークレット

発達

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

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 で Claude を使用するには、次のサーバー構成を追加します。

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サーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

npm run 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>

顧客の詳細を取得する

<access_mcp_resource>
<server_name>erpnext</server_name>
<uri>erpnext://Customer/CUSTOMER001</uri>
</access_mcp_resource>

新しいアイテムを作成

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>create_document</tool_name>
<arguments>
{
  "doctype": "Item",
  "data": {
    "item_code": "ITEM001",
    "item_name": "Test Item",
    "item_group": "Products",
    "stock_uom": "Nos"
  }
}
</arguments>
</use_mcp_tool>

アイテムフィールドを取得する

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