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

license - not tested

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI 어시스턴트가 모델 컨텍스트 프로토콜을 통해 ERPNext/Frappe 시스템과 상호 작용할 수 있도록 하는 TypeScript 기반 서버로, 문서 접근, 레코드 생성/업데이트, 보고서 실행이 가능합니다.

Related MCP Servers

Starwind UI MCP Server
starwind-ui
A
security
A
license
A
quality
A TypeScript server that enhances AI assistants' capabilities when working with Starwind UI components, providing tools for project initialization, component installation, documentation access, and more.
Last updated -
6
19
TypeScript
MIT License
Sentry MCP Server
FaureAlexis
-
security
F
license
-
quality
A TypeScript server that allows AI agents to access, retrieve, and analyze Sentry error data through the Modern Context Protocol.
Last updated -
2
TypeScript
erpnext-server
rakeshgangwar
-
security
F
license
-
quality
This is a TypeScript-based MCP server that provides integration with ERPNext/Frappe API. It enables AI assistants to interact with ERPNext data and functionality through the Model Context Protocol.
Last updated -
4
JavaScript
MIT License
MCP Server TypeScript Template
minimind-org
-
security
F
license
-
quality
A TypeScript template for creating Model Context Protocol servers that enable AI models to utilize external tools, including example operations and simple number addition functionality.
Last updated -
2
TypeScript

View all related MCP servers

ERPNext MCP Server