ArangoDB용 MCP 서버

ArangoDB용 모델 컨텍스트 프로토콜 서버

ArangoDB를 통해 데이터베이스 상호작용 기능을 제공하는 TypeScript 기반 MCP 서버입니다. 핵심 데이터베이스 작업을 구현하고 MCP 도구를 통해 ArangoDB와 원활하게 통합할 수 있습니다. Claude 앱과 함께 사용할 수 있으며, Cline처럼 MCP와 호환되는 VSCode 확장 프로그램도 사용할 수 있습니다!

특징

도구

• arango_query - AQL 쿼리 실행

  • 필수 매개변수로 AQL 쿼리 문자열을 사용합니다.

  • 매개변수화된 쿼리에 대한 바인드 변수를 선택적으로 허용합니다.

  • 쿼리 결과를 JSON으로 반환합니다.

• arango_insert - 컬렉션에 문서 삽입

  • 필수 매개변수로 컬렉션 이름과 문서 객체를 사용합니다.

  • 제공되지 않으면 자동으로 문서 키가 생성됩니다.

  • 생성된 문서 메타데이터를 반환합니다.

• arango_update - 기존 문서 업데이트

  • 필수 매개변수로 컬렉션 이름, 문서 키 및 업데이트 객체를 사용합니다.

  • 업데이트된 문서 메타데이터를 반환합니다.

• arango_remove - 컬렉션에서 문서 제거

  • 필수 매개변수로 컬렉션 이름과 문서 키를 사용합니다.

  • 제거된 문서 메타데이터를 반환합니다.

• arango_backup - 모든 컬렉션을 JSON 파일로 백업

  • 출력 디렉토리 경로를 필수 매개변수로 사용합니다.

  • 현재 데이터를 사용하여 각 컬렉션에 대한 JSON 파일을 생성합니다.

  • 데이터 백업 및 마이그레이션 목적으로 유용합니다.

• arango_list_collections - 데이터베이스의 모든 컬렉션을 나열합니다.

  • 이름, ID, 유형을 포함한 컬렉션 정보 배열을 반환합니다.

• arango_create_collection - 데이터베이스에 새 컬렉션을 만듭니다.

  • 필수 매개변수로 컬렉션 이름을 사용합니다.

  • 선택적으로 컬렉션 유형(문서 또는 에지 컬렉션)을 지정합니다.

  • 쓰기 작업에 대한 waitForSync 동작 구성

  • 이름, 유형, 상태를 포함한 컬렉션 정보를 반환합니다.

Related MCP server: MongoDB MCP Server

설치

NPM을 통해 설치

NPM을 통해 arango-server 전역적으로 설치하려면 다음 명령을 실행하세요.

지엑스피1

NPX를 통해 실행

설치 없이 arango-server 직접 실행하려면 다음 명령을 사용하세요.

VSCode 에이전트 구성

VSCode Copilot 에이전트와 함께 arango-server 사용하려면 최소 VSCode 1.99.0이 설치되어 있어야 하며 다음 단계를 따라야 합니다.

1. MCP 구성 파일을 생성하거나 편집합니다 .

   • 작업 공간별 구성 : 작업 공간에서 .vscode/mcp.json 파일을 만들거나 편집합니다.

   • 사용자별 구성 : 선택적으로, VS Code 사용자 설정의 설정(mcp) 에서 서버를 지정하여 모든 작업 공간에서 MCP 서버를 활성화합니다.

     팁: 구성 파일을 설정하는 방법에 대한 자세한 내용은

2. 다음 구성을 추가합니다 .

   { "servers": { "arango-mcp": { "type": "stdio", "command": "npx", "args": ["arango-server"], "env": { "ARANGO_URL": "http://localhost:8529", "ARANGO_DB": "v20", "ARANGO_USERNAME": "app", "ARANGO_PASSWORD": "75Sab@MYa3Dj8Fc" } } } }

3. MCP 서버를 시작합니다 .

   • VSCode에서 명령 팔레트를 엽니다( Ctrl+Shift+P 또는 Mac에서는 Cmd+Shift+P ).

   • MCP: Start Server 명령을 실행하고 목록에서 arango-mcp 선택합니다.

4. 서버를 확인하세요 :

   • VSCode에서 채팅 보기를 열고 에이전트 모드로 전환합니다.

   • Tools 버튼을 사용하여 arango-server 도구를 사용할 수 있는지 확인하세요.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 ArangoDB를 자동으로 설치하려면:

Claude Desktop과 함께 사용하려면

이동: Settings > Developer > Edit Config 또는

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

Cline VSCode 확장 프로그램과 함께 사용하려면

이동: Cline Extension > MCP Servers > Edit Configuration 또는

• MacOS: ~/Library/Application Support/Code/User/globalStorage/cline.cline/config.json

• 윈도우: %APPDATA%/Code/User/globalStorage/cline.cline/config.json

mcpServers 섹션에 다음 구성을 추가합니다.

환경 변수

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

• ARANGO_URL - ArangoDB 서버 URL(참고: 8529는 로컬 개발을 위한 ArangoDB의 기본 포트입니다)

• ARANGO_DB - 데이터베이스 이름

• ARANGO_USERNAME - 데이터베이스 사용자

• ARANGO_PASSWORD - 데이터베이스 비밀번호

용법

의미 있는 프롬프트를 제공하면 클로드가 적절한 기능을 실행하려고 할 것입니다.

몇 가지 예시 프롬프트:

• "데이터베이스의 모든 컬렉션을 나열합니다"

• "모든 사용자 쿼리"

• "이름이 'John Doe'인 새 문서를 삽입하고 ' john@example.com '을 'users' 컬렉션으로 이메일로 보냅니다."

• "키 '123456' 또는 이름 'Jane Doe'로 문서를 업데이트하여 나이를 48세로 변경하세요."

• "'제품'이라는 이름의 새 컬렉션을 만듭니다."

Claude 앱과 함께 사용

Cline VSCode 확장을 사용한 Uasge

모든 사용자에게 쿼리:

새 문서 삽입:

문서 업데이트:

문서 제거:

모든 컬렉션 나열:

백업 데이터베이스 컬렉션:

새 컬렉션을 만드세요:

참고: 이 서버는 데이터베이스 구조에 구애받지 않으며 ArangoDB의 문서 및 에지 컬렉션 모델을 따르는 한 모든 컬렉션 이름이나 구조로 작업할 수 있습니다.

부인 성명

개발용으로만 사용 가능

이 도구는 로컬 개발 환경 전용으로 설계되었습니다. 기술적으로는 프로덕션 데이터베이스에 연결할 수 있지만, 심각한 보안 위험을 초래할 수 있으므로 권장하지 않습니다. 저희는 관심사 분리(Separation of Concerns)를 유지하고 프로덕션 데이터를 보호하기 위해 개발 데이터베이스에만 이 도구를 사용합니다.

개발

1. 저장소를 복제합니다

2. 종속성 설치:

   npm run build

3. 자동 재빌드를 사용한 개발의 경우:

   npm run watch

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 개발 시 MCP Inspector를 사용하여 디버깅하는 것이 좋습니다.

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

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.