ERPNext MCP 서버

ERPNext 통합을 위한 Model Context Protocol 서버

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

기능

리소스

• erpnext://{doctype}/{name} URI를 통해 ERPNext 문서에 액세스

• 구조화된 데이터 액세스를 위한 JSON 형식

도구

• get_doctypes - 사용 가능한 모든 DocType 목록 가져오기

• get_doctype_fields - 특정 DocType의 필드 목록 가져오기

• get_documents - 특정 doctype의 문서 목록 가져오기

• get_document - 모든 하위 테이블을 포함하여 이름으로 단일 문서 가져오기

• create_document - ERPNext에서 새 문서 생성

• update_document - ERPNext에서 기존 문서 업데이트

• delete_document - 문서 영구 삭제

• submit_document - 문서 제출 (docstatus를 1로 설정)

• cancel_document - 제출된 문서 취소 (docstatus를 2로 설정)

• call_method - ERPNext/Frappe 화이트리스트 서버 측 API 메서드 호출

• run_report - ERPNext 보고서 실행

Related MCP server: ERPNext 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

Inspector는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

사용 예시

고객 목록 가져오기

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