Integrations

Enables access to ERPNext documents and data, with tools for authentication, document management (listing, creating, updating), running reports, and retrieving DocType metadata.
Provides integration with the Frappe framework API, allowing interaction with the underlying platform that powers ERPNext for document and data management.

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のリストを取得します

構成

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

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>

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested