返回市场
生物-mcp

生物-mcp

作者:acashmoney18 星标更新:2025-03-11

项目介绍

BioMCP:增强基于代理的生物医学研发

smithery 徽章 BioMCP

概述

BioMCP 是一个模型上下文协议(MCP)服务器,旨在通过增强大型语言模型来分析蛋白质结构。它提供了分析蛋白质活性位点和搜索与疾病相关的蛋白质工具,通过与已建立的蛋白质数据库接口实现。

未来的工作将集中在使代理能够利用 BioMCP。

特性

  • 活性位点分析:使用 PDB ID 分析蛋白质的结合位点和功能残基
  • 疾病-蛋白质搜索:查找与特定疾病或医疗条件相关的蛋白质结构
  • 集成数据访问:无缝连接 RCSB 蛋白质数据银行(PDB)

技术细节

BioMCP 实现了模型上下文协议,允许语言模型访问专门的蛋白质结构知识,而无需这些信息成为其训练数据的一部分。该服务器处理 API 连接、数据格式化和错误处理,以提供可靠的蛋白质结构洞察。

API 端点

BioMCP 提供两个主要工具:

  1. analyze-active-site:使用 PDB ID 提供关于蛋白质结合位点的详细信息
  2. search-disease-proteins:返回与指定疾病或医疗条件相关的蛋白质

快速开始

通过 Smithery 安装

要通过 Smithery 自动安装 BioMCP 到 Claude Desktop:

npx -y @smithery/cli install @acashmoney/bio-mcp --client claude

手动安装

# 克隆仓库
git clone https://github.com/acashmoney/bio-mcp.git

# 安装依赖
npm install

# 启动服务器
npm start

设置说明

运行 MCP Inspector

  1. 启动 BioMCP 服务器:

    npm start
    
  2. 在另一个终端中,全局安装 MCP Inspector(如果尚未安装):

    npm install -g @anthropic-ai/mcp-inspector
    
  3. 启动 MCP Inspector 并连接到本地的 BioMCP 服务器:

    npx @modelcontextprotocol/inspector node build/index.js
    
  4. 使用 inspector 接口测试工具并查看响应。

与 Claude Desktop 配合使用

  1. 构建 BioMCP 服务器:

    npm run build
    
  2. 配置 Claude Desktop 启动 MCP 服务器:

    a. 查找你的 Claude Desktop config.json 文件(通常在用户目录下)

    b. 编辑 config.json 以包含 BioMCP 服务器构建路径。示例配置:

    {
      "globalShortcut": "",
      "mcpServers": {
        "bio-mcp": {
          "command": "node",
          "args": [
            "/path/to/your/build/index.js"
          ]
        }
      }
    }
    

    c. 将 /path/to/your/build 替换为你项目的实际路径。

  3. 重启 Claude Desktop 使更改生效。

  4. 现在你可以向 Claude 提问,利用 BioMCP 工具:

    • "PDB 结构 6LU7 的活性位点的关键残基是什么?"
    • "找到与阿尔茨海默病相关的蛋白质"

示例用法

当与兼容的语言模型集成时,Bio-MCP 可以支持如下查询:

  • "PDB 结构 6LU7 的活性位点的关键残基是什么?"
  • "找到与阿尔茨海默病相关的蛋白质"

要求

  • Node.js 20.0.0 或更高版本
  • TypeScript 5.0+
  • 兼容的 MCP 客户端实现

测试

BioMCP 包含一个全面的测试套件,包括单元测试、集成测试和端到端测试。

运行测试

运行所有测试:

npm test

运行特定的测试套件:

# 单元测试
npm run test:unit

# 集成测试(API 交互)
npm run test:integration

# 端到端测试
npm run test:e2e

代码检查

检查代码质量:

npm run lint

自动修复代码检查问题:

npm run lint:fix

发展路线图

  • 扩大活性位点描述的详细程度
  • 利用三维坐标
  • 与文献对接的工具
  • 与计算生物学模型对接的工具:
    • RFdiffusion
    • ProteinMPNN
    • ColabFold
    • 其他蛋白质设计和结构预测工具
  • 基于代理的研究流水线
  • 引入带有蛋白质可视化工具的客户端