아카이브 알림

이 저장소는 아카이브 처리 중입니다.

AIND 메타데이터 MCP 서버

포괄적인 도구 및 리소스 세트를 통해 AIND(Allen Institute for Neural Dynamics) 메타데이터 및 데이터 자산에 대한 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다.

[!WARNING] 이 MCP 서버는 더 이상 사용되지 않습니다(deprecated). V1 메타데이터에 액세스하기 위해 계속 사용할 수는 있습니다. V2 메타데이터는 aind-data-mcp를 참조하십시오.

기능

이 MCP 서버는 다음을 위한 도구를 제공합니다:

• 데이터 검색: 필터 및 프로젝션을 사용하여 MongoDB 컬렉션 쿼리

• 집계: 복잡한 MongoDB 집계 파이프라인 실행

• 스키마 탐색: 상세한 스키마 예제 및 문서 액세스

• NWB 파일 액세스: NWB(Neurodata Without Borders) 파일 로드 및 탐색

• 데이터 요약: 데이터 자산에 대한 AI 기반 요약 생성

Related MCP server: Allen Brain API MCP Server

설치

아직 설치하지 않았다면 이 문서에 따라 uv를 설치하십시오.

uv를 사용하여 MCP 서버를 설치합니다:

uv tool install aind-metadata-mcp

또는 pip를 사용합니다:

pip install aind-metadata-mcp

구성

Cline (VSCode 확장 프로그램)용

MCP 서버가 선호하는 클라이언트에서 실행되도록 하려면 aind-metadata-mcp 패키지를 콘솔에 다운로드해야 합니다. 공간이 부족한 경우, 다음 단계를 진행하기 전에 UV_CACHE_DIR 및 UV_TOOL_DIR을 용량이 충분한 위치로 설정하십시오.

1. 간단한 설치 버전 터미널에서 uv tool install aind-metadata-mcp를 실행하고 아래의 MCP 클라이언트 구성 단계로 진행하십시오.

2. 위 단계가 작동하지 않는 경우:

IDE에서 python 3.11로 가상 환경 생성

# Instructions for Conda
conda create -n <my_env> python=3.11
conda activate <my_env>

# Instructions for virtual environment
py -3.11 -m venv .venv
# Windows startup
.venv\Scripts\Activate.ps1 
# Mac/ Linux startup
source .venv/bin/activate 

IDE 터미널에서 다음 명령을 실행하십시오.

pip install uv
uvx aind-metadata-mcp

모든 것이 잘 진행되어 Starting MCP server 'aind_data_access' with transport 'stdio'라는 알림이 표시되면, 선택한 클라이언트에서 설정할 준비가 된 것입니다!

Cursor IDE

1. MCP 서버 설치:

   uv tool install aind-metadata-mcp

2. MCP 구성 파일 생성:

   mkdir -p ~/.cursor

3. 다음 내용으로 ~/.cursor/mcp.json 생성:

   {
     "mcpServers": {
       "aind-data-access": {
         "command": "aind-metadata-mcp",
         "args": [],
         "env": {}
       }
     }
   }

4. 중요: 필요한 경우 aind-metadata-mcp를 전체 경로로 바꾸십시오:

   which aind-metadata-mcp

   command 필드에 전체 경로(예: /Users/username/.local/bin/aind-metadata-mcp)를 사용하십시오.

5. Cursor를 완전히 다시 시작하십시오 (Cmd+Q 후 다시 열기)

참고: Cursor는 VSCode와 다른 MCP 구성 시스템을 사용합니다. 구성은 기본 settings.json 파일이 아닌 ~/.cursor/mcp.json에 있어야 합니다.

MCP 클라이언트 사용 지침

클라이언트에서 MCP 서버를 추가하기 위한 JSON 구성 파일은 다음과 같이 구성되어야 합니다.

{
    "mcpServers": {

    }
}

mcpServers 딕셔너리에 다음 줄을 삽입하십시오.

"aind_data_access": {
      "disabled": false,
      "timeout": 300,
      "type": "stdio",
      "command": "aind-metadata-mcp"
}

JSON 파일을 구성한 후 서버가 클라이언트에 나타나기까지 몇 분 정도 걸릴 수 있습니다.

Claude 데스크톱 앱

• 화면 왼쪽 상단의 세 줄을 클릭합니다.

• 파일 > 설정 > 개발자 > 구성 편집

VSCode의 Cline

• Cline이 VSCode에 다운로드되었는지 확인합니다.

• Cline 창 오른쪽 상단의 쌓여 있는 사각형 세 개를 클릭합니다.

• 설치됨 > MCP 서버 구성

• VSCode를 닫고 다시 엽니다.

VSCode의 Github Copilot

• 명령 팔레트 (ctr shift p)

• MCP: 서버 추가 검색

• Manual Install / stdio 선택

• 명령을 입력하라는 메시지가 표시되면 uvx aind-data-access를 입력합니다.

• 서버 이름을 지정합니다.

• VSCode를 닫고 다시 엽니다.

• Copilot 채팅 -> 에이전트 모드 선택 -> 쌓여 있는 사각형 세 개를 클릭하여 도구 구성

• 에이전트가 AIND API 컨텍스트로 응답할 수 있도록 하려면 이 저장소의 (리소스 아래에 있는) .txt 파일을 수동으로 추가해야 합니다.

Code Ocean에서 사용

• 다음 캡슐을 찾아 aind-metadata-mcp가 사전 설치된 Cline 및 Co-pilot을 실행하십시오.

• 추가 지원은 code ocean MCP 서버를 참조하십시오.

• 버전 4.2 또는 4.5를 고정하십시오.