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 통합을 위한 모델 컨텍스트 프로토콜 서버

ERPNext/Frappe API와의 통합을 제공하는 TypeScript 기반 MCP 서버입니다. AI 어시스턴트가 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 ERPNext 데이터 및 기능과 상호 작용할 수 있도록 지원합니다.

특징

자원

erpnext://{doctype}/{name} URI를 통해 ERPNext 문서에 액세스합니다.
구조화된 데이터 액세스를 위한 JSON 형식

도구

authenticate_erpnext - 사용자 이름과 비밀번호를 사용하여 ERPNext에 인증합니다.
get_documents - 특정 doctype에 대한 문서 목록을 가져옵니다.
create_document - ERPNext에서 새 문서를 만듭니다.
update_document - ERPNext에서 기존 문서 업데이트
run_report - ERPNext 보고서 실행
get_doctype_fields - 특정 DocType에 대한 필드 목록을 가져옵니다.
get_doctypes - 사용 가능한 모든 DocTypes 목록 가져오기

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

ERPNEXT_URL - ERPNext 인스턴스의 기본 URL
ERPNEXT_API_KEY (선택 사항) - 인증을 위한 API 키
ERPNEXT_API_SECRET (선택 사항) - 인증을 위한 API 비밀번호

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

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