VFB3 MCP

VFB3-MCP服务器

用于与VirtualFlyBrain（VFB）API交互的模型上下文协议（MCP）服务器。此服务器提供查询VFB数据、运行查询和搜索术语的工具。

🚀 快速开始

使用实时服务（推荐）

使用VFB3-MCP的最简单方法是通过我们的托管服务 https://vfb3-mcp.virtualflybrain.org。这不需要在您的计算机上安装或设置。

Claude桌面设置

1. 打开克劳德桌面 然后转到“设置”
2. 导航到MCP部分
3. 添加新的MCP服务器 使用这些设置：

- 服务器名称: virtual-fly-brain （或您喜欢的任何名称） - 类型：HTTP - 服务器URL: https://vfb3-mcp.virtualflybrain.org

配置JSON （替代方法）：

{
  "mcpServers": {
    "virtual-fly-brain": {
      "url": "https://vfb3-mcp.virtualflybrain.org"
    }
  }
}

Claude代码设置

1. 找到您的Claude配置文件:

- macOS/Linux: ~/.claude.json - 视窗: %USERPROFILE%\.claude.json

1. 添加VFB3-MCP服务器 根据您的配置：

{
  "mcpServers": {
    "virtual-fly-brain": {
      "url": "https://vfb3-mcp.virtualflybrain.org"
    }
  }
}

1. 重新启动Claude代码 使更改生效

GitHub副本设置

1. 打开VS代码 已安装GitHub Copilot
2. 打开设置 (Ctrl/Cmd + ,)
3. 搜索“MCP” 在设置搜索中
4. 查找MCP服务器设置
5. 添加服务器URL: https://vfb3-mcp.virtualflybrain.org
6. 给它起个名字 比如“虚拟飞行大脑”

Visual Studio代码（带MCP扩展）

1. 安装MCP扩展 来自市场的VS Code
2. 打开命令选项板 (Ctrl/Cmd + Shift + P)
3. 键入“MCP:添加服务器” 并选择它
4. 选择“HTTP” 作为服务器类型
5. 输入服务器详细信息:

- 名字: virtual-fly-brain - 统一资源定位符: https://vfb3-mcp.virtualflybrain.org

1. 保存并重新启动 VS代码（如果提示）

其他MCP客户端

对于任何支持HTTP服务器的MCP兼容客户端：

{
  "mcpServers": {
    "virtual-fly-brain": {
      "url": "https://vfb3-mcp.virtualflybrain.org",
      "type": "http"
    }
  }
}

测试连接

配置后，您可以通过让您的AI助手执行以下操作来测试VFB3-MCP是否正常工作：

• “获取有关术语VFB_jrcv0i43的信息”
• “搜索与髓质相关的术语”
• “运行VFB_00101567的PaintedDomains查询”

如果您看到VirtualFlyBrain数据的响应，则设置成功！

🛠️ 本地安装

先决条件

• Node.js 18或更高版本
• npm或纱线

分步安装

1. 克隆仓库:

   git clone https://github.com/Robbie1977/VFB3-MCP.git
   cd VFB3-MCP

1. 安装依赖项:

   npm install

1. 构建项目:

   npm run build

1. 启动服务器:

   npm start

平台特定设置

Claude Desktop（本地开发）

对于使用Claude Desktop进行本地开发，请将以下内容添加到您的MCP配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vfb3-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/VFB3-MCP/dist/index.js"]
    }
  }
}

克劳德代码

添加到您的 claude.json 文件：

{
  "mcpServers": {
    "vfb3-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/VFB3-MCP/dist/index.js"]
    }
  }
}

Visual Studio Code

1. 安装VS Code的MCP扩展
2. 按 Cmd + Shift + P （macOS）或 Ctrl + Shift + P （Windows/Linux）
3. 选择 MCP:添加服务器…
4. 选择 命令 类型
5. 输入：

- 名字: vfb3-mcp - 命令: node - 参数: /absolute/path/to/VFB3-MCP/dist/index.js

GitHub Copilot

在Copilot设置中配置MCP服务器URL以指向本地服务器：

http://localhost:3000

对于HTTP模式测试：

MCP_MODE=http PORT=3000 node dist/index.js

Docker安装

使用Docker Compose （推荐）：

docker-compose up --build

手动Docker构建:

# Build the image
docker build -t vfb3-mcp .

# Run the container
docker run -p 3000:3000 vfb3-mcp

拉取预构建图像:

docker pull virtualflybrain/vfb3-mcp:latest
docker run -p 3000:3000 virtualflybrain/vfb3-mcp:latest

可用工具

get_term_info

使用VFB术语的ID检索其详细信息。

参数：

• id （字符串）：VFB ID（例如，“VFB_jrcv0i43”）

run_query

对VFB数据执行预定义查询。

参数：

• id （字符串）：VFB ID（例如，“VFB_00101567”）
• query_type （string）：查询类型（例如，“PaintedDomains”）

搜索_术语

使用Solr搜索服务器搜索VFB术语。

参数：

• query （string）：搜索查询（例如“髓质”）

🧠 关于VirtualFlyBrain

VirtualFlyBrain（VFB）是一个关于 *黑腹果蝇* 神经生物学，为蝇脑研究提供3D图像、基因表达数据、神经连接信息和标准化术语。

📖 文档

• 法学硕士指导：AI助手有效使用此MCP的指南
• 例子：使用示例和集成指南
• 技术文档：基础设施、部署和开发细节

📄 许可证

麻省理工学院