PolarHub
  • Agents
  • MCP Servers
  • Skills
  • PolarBear
PolarHub © 2026
MCP Serversresearch-and-datapickleton89
返回「research-and-data」

pickleton89

modelscope·@pickleton89/cbioportal-mcp

research-and-data0下载LocalModelScope

简介

暂无描述。

MCP Server 详情

来自 ModelScope 索引

cBioPortal MCP 服务器

Python 3.8+ MCP FastMCP

这是一个高性能的异步模型上下文协议(MCP)服务器,使AI助手能够与cBioPortal中的癌症基因组数据进行交互。cBioPortal是一个探索多维癌症基因组数据集的平台。该服务器使用现代异步Python构建,以实现显著更快的数据检索速度。

功能

  • 🔍 癌症研究:浏览和搜索cBioPortal中可用的癌症研究
  • 🧬 基因组数据:访问基因突变、临床数据和分子谱型
  • 🔎 搜索功能:通过关键词搜索研究、基因和样本
  • 📊 多种数据类型:检索突变、临床数据和研究元数据
  • ⚡ 异步性能:完全异步实现,显著加快数据检索速度(最高可达4.5倍)
  • 📚 批量操作:并发获取多个研究和基因以提高性能
  • 🔄 FastMCP集成:基于高性能FastMCP框架构建

目录

  • 安装
  • 使用
  • 配置
  • 可用工具
  • 示例
  • 故障排除
  • 开发
  • 许可证

安装

先决条件

  • Python 3.8或更高版本
  • pip(Python包管理器)
  • Git(可选,用于克隆仓库)

设置环境

选项1:使用venv和pip(标准方法)

bash

创建虚拟环境

python -m venv cbioportal-mcp-env

激活环境

在Windows上:

cbioportal-mcp-envScriptsactivate

在macOS/Linux上:

source cbioportal-mcp-env/bin/activate

使用pip安装依赖项

bash

安装MCP SDK和FastMCP框架

pip install mcp>=2.0.0

安装其他依赖项

pip install httpx asyncio

选项2:使用UV(更快的替代方案)

UV 是一个现代的高性能Python包管理和环境管理工具,比pip快得多。

bash

如果还没有安装UV,请先安装

pipx install uv

或者使用Homebrew

brew install uv

使用UV创建并激活虚拟环境

uv venv

激活环境

在Windows上:

.venvScriptsactivate

在macOS/Linux上:

source .venv/bin/activate

使用UV安装依赖项

bash

安装MCP SDK和FastMCP框架

uv pip install mcp>=2.0.0

安装其他依赖项

uv pip install httpx asyncio

下载服务器

将cbioportal_server.py脚本下载到工作目录,或者克隆此仓库:

bash git clone https://github.com/pickleton89/cbioportal-mcp.git cd cbioportal-mcp

使脚本可执行(仅限Linux/macOS)

bash chmod +x cbioportal_server.py

使用

启动服务器

使用默认设置启动服务器:

bash python cbioportal_server.py

这将使用公共cBioPortal API https://www.cbioportal.org/api 启动服务器。

高级选项

使用命令行参数自定义服务器行为:

bash

使用不同的cBioPortal API实例

python cbioportal_server.py --base-url https://your-cbioportal-instance.org/api

指定不同的传输机制(目前仅支持stdio)

python cbioportal_server.py --transport stdio

配置

与Claude Desktop一起使用

  1. 安装Claude Desktop
  2. 打开Claude Desktop
  3. 点击工具栏中的MCP Servers图标
  4. 添加一个新的MCP服务器,并使用以下配置:

json { "mcpServers": { "cbioportal": { "command": "/Users/jeffkiefer/Documents/projects/cbioportal_MCP/.venv/bin/python3", "args": ["/Users/jeffkiefer/Documents/projects/cbioportal_MCP/cbioportal_server.py"], "env": {} } } }注意: 请确保将路径替换为实际的Python可执行文件和服务器脚本路径。command字段应指向虚拟环境中的Python可执行文件(例如,.venv/bin/python3),而args数组的第一个元素应该是cbioportal_server.py脚本的路径。如果遇到ENOTDIR错误,请确保command字段正确设置为Python可执行文件而不是目录。

使用VS Code

在工作区设置中配置MCP服务器:

json { "mcp.servers": { "cbioportal": { "command": "python", "args": ["/path/to/cbioportal_server.py"] } } }

可用工具

cBioPortal MCP服务器提供了以下工具:

工具名称描述
get_cancer_studies列出cBioPortal中所有可用的癌症研究
get_cancer_types获取所有癌症类型的列表
get_study_details获取特定癌症研究的详细信息
get_samples_in_study获取与某项研究相关的样本列表
get_genes通过Hugo符号或Entrez ID获取特定基因的信息
search_genes通过关键词搜索基因的符号或名称
get_mutations_in_gene获取给定研究中特定基因的突变情况
get_clinical_data获取研究中患者的临床数据
get_molecular_profiles获取某项研究可用的分子谱型列表
search_studies通过关键词搜索癌症研究
get_multiple_studies并发获取多个研究以提高性能
get_multiple_genes自动分批并发检索多个基因

示例

这里是一些你可以向连接到此服务器的人工智能助手提问的例子:

"cBioPortal中有哪些可用的癌症研究?" "在cBioPortal中搜索黑色素瘤研究" "获取BRCA1基因的信息" "乳腺癌研究中TP53存在哪些突变?" "查找与肺癌相关的研究" "获取TCGA乳腺癌研究中患者的临床数据"

性能

该服务器实现了完全异步支持,显著提高了从cBioPortal API检索数据时的性能。

基准测试结果

我们的测试显示,使用异步实现后性能有显著提升:

  • 并发获取研究的速度比顺序操作快4.57倍
  • 高效批量处理多个基因的检索
  • 顺序操作与并发操作之间保持一致的数据质量

批量操作的优势

服务器提供专门用于利用并发性的批量操作工具:

  • get_multiple_studies: 使用asyncio.gather并行获取多个研究
  • get_multiple_genes: 实现智能分批以高效并发检索基因

这些方法包括详细的性能指标,如执行时间和批次计数,帮助您了解效率提升情况。

故障排除

服务器启动失败

  • 确保已安装Python 3.8+:python --version
  • 验证所有依赖项均已安装:pip list | grep mcp
  • 检查控制台中的错误消息

Claude桌面版连接问题

  • 确认配置中的脚本路径正确
  • 确保脚本具有执行权限
  • 查看Claude日志以获取详细的错误信息

API连接问题

  • 确保互联网连接正常
  • 验证cBioPortal API是否可访问:curl https://www.cbioportal.org/api/cancer-types
  • 如果可能,尝试使用不同的API端点

开发

扩展服务器功能

您可以通过向CBioPortalMCPServer类添加新方法并将它们注册为工具来扩展服务器的功能:

python

添加一个新方法

def my_new_tool(self, parameter1: str, parameter2: int) -> Dict: # 实现 return {"result": "data"}

注册新工具

self.mcp.tool()(self.my_new_tool)### 未来改进

未来版本的潜在改进:

  • 对频繁访问的数据进行缓存
  • 支持私有 cBioPortal 实例的身份验证
  • 增加更多端点以提供更全面的数据访问
  • 根据服务器性能微调并发限制
  • 添加请求重试机制以实现更健壮的错误处理
  • 为其他端点实现更多的并发批量操作方法

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢

  • cBioPortal 提供开放访问的癌症基因组数据平台
  • Model Context Protocol 使 AI 工具交互成为可能
  • FastMCP 提供高性能的 MCP 服务器框架

相关 MCP Servers(来自「research-and-data」)

菜谱

看起来您想要翻译一份英文技术文档,但您提供的内容中只有"asd"这个字符串,并没有实际的文档内容。请提供需要翻译的具体英文技术文档文本,这样我才能帮助您进行准确的翻译。如果有特定部分或格式要求,请一并告知。

lcd18601611267/whateat

健康指标评估-MCP&Agent挑战赛

本项目是一个基于 Gradio 的健康参数计算器 Web 应用。用户只需输入性别、年龄、身高、体重等基础信息(必填),以及腰围、甘油三酯、HDL胆固醇等可选健康数据,即可一键计算出多项常用健康指标,包括 BMI、BSA、腰高比、CI、CMI、CVAI、LAP、BFR、RFM 等,并给出健康评估建议。

dudu007/HealthCalculator

快递100 MCP Server

快递100 MCP Server提供快递信息查询、快递运费预估比价、快递时效查询(含发货前时效查询与在途动态时效查询)等功能。

kuaidi100/kuaidi100-mcp

网络基础数据查询

网络基础数据,包括passivedns解析数据、域名和IP的注册信息、网站证书、IOC库的查询。 数据来源于奇安信X实验室被动收集的大网安全研究、威胁分析溯源和大规模多维度安全数据平台。

dongkitchen/fdp_basic

域名相关基础数据查询

网络基础数据中和域名相关数据的查询工具。包括伴生域名、域名排名、域名网页数据、Libra基础数据平台的域名关联数据。

dongkitchen/fdp_domain

AKSHARE金融数据服务

暂无描述。

darwinl/akshare_mcp_server

自动安装

点击按钮会唤起 PolarBear 客户端,并把当前 MCP Server 的 Markdown 详情文档地址传给客户端。

/api/mcps/pickleton89-cbioportal-mcp/markdown
打开 PolarBear 安装查看 Markdown 文档

手动安装

在 PolarBear 或其他支持 MCP 的客户端中,新建 MCP Server,并参考下方来源或安装提示配置。

暂未识别到安装命令,请打开 ModelScope 详情查看完整配置。

基本信息

分类
research-and-data / bioinformatics
运行方式
No
许可证
MIT License
详情文件
pickleton89-cbioportal-mcp.md