元数据协议服务器

存档通知

此仓库正在存档。

AIND元数据MCP服务器

MCP（模型上下文协议）服务器，通过一套全面的工具和资源提供对AIND（艾伦神经动力学研究所）元数据和数据资产的访问。

[！警告] 此MCP服务器已弃用。您可以继续使用它来访问V1元数据。
有关V2元数据，请参阅 aind数据mcp.

特性

此MCP服务器提供以下工具：

• 数据检索：使用过滤器和投影查询MongoDB集合
• 聚合：执行复杂的MongoDB聚合管道
• 模式探索：访问详细的模式示例和文档
• NWB文件访问：加载和浏览NWB（无国界神经数据）文件
• 数据摘要：生成基于人工智能的数据资产摘要

安装

如果你还没有安装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'-，你应该为你选择的客户做好准备！

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

   使用完整路径（例如。， /Users/username/.local/bin/aind-metadata-mcp)在 command 现场。

5. 完全重新启动游标（Cmd+Q然后重新打开）

备注：Cursor使用与VSCode不同的MCP配置系统。配置必须在 ~/.cursor/mcp.json，不在主settings.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副本

• 命令面板（ctrl-shift p）
• 搜索MCP：添加服务器
• 选择 Manual Install / stdio
• 当系统提示输入命令时，输入 uvx aind-data-access
• 命名您的服务器
• 关闭并重新打开VSCode
• 在Copilot聊天->选择代理模式->单击三个堆叠的矩形以配置工具
• 为了使代理能够使用AIND API的上下文进行回复，您必须手动添加此存储库中的.txt文件（在资源下）

用于Code Ocean

• 找到 以下胶囊，使用预装的aind元数据mcp启动Cline和Co-pilot。
• 请参阅 代码海洋MCP服务器 获得额外支持
• 引脚版本4.2或4.5