Cortellis MCP Server

by uh-joan
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides access to the Cortellis drug database by Clarivate, enabling search for drug information, development status, and exploration of ontology/taxonomy terms with comprehensive filtering options.

Cortellis MCP 服务器

MCP 服务器用于在 Cortellis 数据库中搜索药物和探索本体术语。

安装

# Using npm npm install @uh-joan/cortellis-mcp-server

快速入门

  1. 设置环境变量:
CORTELLIS_USERNAME=your_username CORTELLIS_PASSWORD=your_password USE_HTTP=true # Optional: run as HTTP server PORT=3000 # Optional: specify port for HTTP server
  1. 运行服务器:
# As MCP server npx cortellis-mcp-server # As HTTP server USE_HTTP=true PORT=3000 npx cortellis-mcp-server

工具

  1. search_drugs
    • 在 Cortellis 数据库中搜索药物
    • 可选输入:
      • query (字符串)- 原始搜索查询
      • company (字符串)- 开发药物的公司
      • indication (字符串)- 有效适应症(例如肥胖症)
      • action (字符串)- 目标特定动作(例如胰高血糖素)
      • phase (字符串)- 开发状态:
        • 支持简短和描述格式:
          • 短格式:S、DR、CU、C1-C3、PR、R、L、OL、NDR、DX、W
          • 描述格式:“1期临床”、“2期临床”、“3期临床”、“已推出”等。
        • 支持 OR/AND 运算符:“C2 OR C3”或“Phase 2 Clinical OR Phase 3 Clinical”
        • 例子:
          • phase: "C3" (短格式)
          • phase: "C2 OR C3" (短格式)
          • phase: "Phase 2 Clinical OR Phase 3 Clinical" (描述格式)
          • phase: "C2 AND C3" (使用 AND 运算符)
        • 状态代码:
          • S:暂停
          • DR:发现/临床前
          • CU:临床(未知阶段)
          • C1-C3:1-3期临床
          • PR:预注册
          • R:已注册
          • L:已启动
          • OL:未获授权
          • NDR:未报告任何进展
          • DX:已停产
          • W:已撤回
      • phase_terminated (字符串) - NDR/DX 之前的最后阶段
        • 支持与phase相同的格式和运算符
        • 例子:
          • phase_terminated: "C2 OR CR" (短格式)
          • phase_terminated: "C2" (短格式)
          • phase_terminated: "Phase 2 Clinical" (描述格式)
          • phase_terminated: "C2 OR C3" (多个阶段)
      • technology (字符串)- 药物技术(例如小分子)
      • drug_name (字符串)- 药物名称
      • country (字符串) - 发展国家
      • offset (数字)- 用于分页
    • 返回:包含药物信息和开发状态的 JSON 响应
  2. explore_ontology
    • 探索 Cortellis 数据库中的分类术语
    • 可选输入(至少一个必填):
      • term (字符串)- 通用搜索词
      • category (字符串)- 要搜索的类别
      • action (字符串)- 针对特定动作
      • indication (字符串)- 疾病/状况
      • company (字符串)- 公司名称
      • drug_name (字符串)- 药品名称
      • target (字符串) - 药物目标
      • technology (字符串)- 药物技术
    • 返回:具有匹配分类术语的 JSON 响应
  3. get_drug
    • 返回包含给定标识符的所有可用字段的完整药品记录
    • 必填输入:
      • id (字符串)- 药品标识符
    • 返回:包含完整药物记录的 JSON 响应
  4. get_drug_swot
    • 返回补充所选药物记录的 SWOT 分析
    • 必填输入:
      • id (字符串)- 药品标识符
    • 返回:包含药物 SWOT 分析的 JSON 响应
  5. get_drug_financial
    • 返回财务评论和数据(实际销售额和一致预测)
    • 必填输入:
      • id (字符串)- 药品标识符
    • 返回:带有财务数据和评论的 JSON 响应
  6. get_company
    • 返回包含给定标识符的所有可用字段的整个公司记录
    • 必填输入:
      • id (字符串)- 公司标识符
    • 返回:包含完整公司记录的 JSON 响应
  7. search_companies
    • 在 Cortellis 数据库中搜索公司
    • 可选输入:
      • query (字符串)- 原始搜索查询
      • company_name (字符串) - 要搜索的公司名称
      • hq_country (字符串) - 公司总部所在国家
      • deals_count (字符串) - 统计公司作为委托人/合伙人的所有不同交易的数量
        • 格式:'<20' 表示少于 20 笔交易
        • 格式:'20' 或 '>20' 表示超过 20 笔交易(默认行为)
      • indications (字符串) - 前 10 个适应症术语
      • actions (字符串)- 前 10 个基于目标的动作术语
      • technologies (字符串)- 十大技术术语
      • company_size (字符串) - 公司规模(以十亿美元为单位)
        • 格式:'<2' 表示少于 20 亿美元
        • 格式:'2' 或 '>2' 表示大于 $2B(默认行为)
      • status (字符串) - 关联药物的最高状态
      • offset (数字)- 用于分页
    • 返回:包含公司信息的 JSON 响应

特征

  • 直接访问 Cortellis 药物数据库
  • 全面的药物开发状态搜索
  • 本体/分类学术语探索
  • 详细药品信息检索
  • 药品的SWOT分析
  • 财务数据和预测
  • 结构化 JSON 响应
  • 大型结果集的分页支持

HTTP API 端点

在 HTTP 模式(USE_HTTP=true)下运行时,以下 REST 端点可用:

  1. POST /search_drugs
    • 使用可选过滤器搜索药品
    • 主体:带有搜索参数的 JSON 对象(请参阅search_drugs工具输入)
  2. POST /explore_ontology
    • 搜索分类术语
    • 主体:带有搜索参数的 JSON 对象(参见explore_ontology工具输入)
  3. GET /drug/:id
    • 通过ID获取完整的药物记录
    • 参数:
      • id :药品标识符
  4. GET /drug/:id/swot
    • 获取药物的 SWOT 分析
    • 参数:
      • id :药品标识符
  5. GET /drug/:id/financial
    • 获取药品的财务数据和预测
    • 参数:
      • id :药品标识符
  6. GET /company/:id
    • 通过ID获取完整的公司记录
    • 参数:
      • id :公司标识符
  7. POST /search_companies
    • 使用可选过滤器搜索公司
    • 主体:带有搜索参数的 JSON 对象(请参阅search_companies工具输入)

设置

环境变量

服务器需要 Cortellis API 凭证:

CORTELLIS_USERNAME=your_username CORTELLIS_PASSWORD=your_password

在 Claude Desktop 上安装

开始之前,请确保您的桌面上安装了Node.js ,以使npx能够正常工作。

  1. 前往:设置 > 开发者 > 编辑配置
  2. 将以下内容添加到您的claude_desktop_config.json中:
{ "mcpServers": { "cortellis": { "command": "npx", "args": [ "-y", "@uh-joan/cortellis-mcp-server" ], "env": { "CORTELLIS_USERNAME": "your_username", "CORTELLIS_PASSWORD": "your_password" } } } }
  1. 重新启动 Claude Desktop 并开始探索药物开发数据!

构建(针对开发者)

git clone https://github.com/uh-joan/cortellis-mcp-server.git cd cortellis-mcp-server npm install npm run build

对于本地开发:

# Copy example environment file cp .env.example .env # Edit .env with your credentials vim .env # or use your preferred editor # Start the server npm run start

Docker

docker build -t cortellis-mcp-server . docker run -i --env-file .env cortellis-mcp-server

执照

此 MCP 服务器根据 MIT 许可证获得许可。

免责声明

Cortellis™ 是科睿唯安 (Clarivate Analytics) 的商业产品和商标。此 MCP 服务器需要有效的 Cortellis API 凭证才能运行。如需获取凭证并了解更多关于 Cortellis 的信息,请访问科睿唯安的 Cortellis 页面

本项目与科睿唯安 (Clarivate Analytics) 并无关联,亦未获得其认可或赞助。所有产品名称、徽标和品牌均为其各自所有者的财产。

贡献

欢迎贡献代码!欢迎提交 Pull 请求。对于重大变更,请先提交一个 issue 来讨论您想要修改的内容。

版本控制

我们使用SemVer进行版本控制。有关可用版本,请参阅此存储库上的标签

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

能够在 Cortellis 数据库中搜索药物并探索本体术语,从而可以通过结构化的 JSON 响应访问全面的药物开发状态信息。

  1. Installation
    1. Quick Start
      1. Tools
        1. Features
          1. HTTP API Endpoints
            1. Setup
              1. Environment Variables
              2. Installing on Claude Desktop
            2. Build (for devs)
              1. Docker
                1. License
                  1. Disclaimer
                    1. Contributing
                      1. Versioning
                        ID: aja3irnmpw