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>

ERPNext MCP Server