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: erpnext-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>