Cortellis MCP 服务器

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

安装

# 使用 npm
npm install @uh-joan/cortellis-mcp-server

快速开始

1. 设置您的环境变量：

CORTELLIS_USERNAME=您的用户名
CORTELLIS_PASSWORD=您的密码
USE_HTTP=true  # 可选：作为 HTTP 服务器运行
PORT=3000      # 可选：指定 HTTP 服务器的端口

2. 运行服务器：

# 作为 MCP 服务器
npx cortellis-mcp-server

# 作为 HTTP 服务器
USE_HTTP=true PORT=3000 npx cortellis-mcp-server

工具

1. search_drugs

   • 在 Cortellis 数据库中搜索药物
   • 可选输入：
     • query (string) - 原始搜索查询
     • company (string) - 开发药物的公司
     • indication (string) - 活性适应症（例如，肥胖症）
     • action (string) - 靶标特定作用（例如，胰高血糖素）
     • phase (string) - 研发状态：
       • 支持短格式和描述性格式：
         • 短格式：S, DR, CU, C1-C3, PR, R, L, OL, NDR, DX, W
         • 描述性格式："Phase 1 Clinical", "Phase 2 Clinical", "Phase 3 Clinical", "Launched" 等。
       • 支持 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: Suspended (暂停)
         • DR: Discovery/Preclinical (发现/临床前)
         • CU: Clinical (unknown phase) (临床（未知阶段）)
         • C1-C3: Phase 1-3 Clinical (1-3 期临床)
         • PR: Pre-registration (预注册)
         • R: Registered (已注册)
         • L: Launched (已上市)
         • OL: Outlicensed (已授权)
         • NDR: No Development Reported (未报告开发)
         • DX: Discontinued (已停止)
         • W: Withdrawn (已撤回)
     • phase_terminated (string) - NDR/DX 之前的最后阶段
       • 支持与 phase 相同的格式和运算符
       • 示例：
         • phase_terminated: "C2 OR CR" (短格式)
         • phase_terminated: "C2" (短格式)
         • phase_terminated: "Phase 2 Clinical" (描述性格式)
         • phase_terminated: "C2 OR C3" (多个阶段)
     • technology (string) - 药物技术（例如，小分子）
     • drug_name (string) - 药物名称
     • country (string) - 开发国家/地区
     • offset (number) - 用于分页
   • 返回：包含药物信息和研发状态的 JSON 响应

2. explore_ontology

   • 探索 Cortellis 数据库中的分类术语
   • 可选输入（至少需要一个）：
     • term (string) - 通用搜索词
     • category (string) - 要在其中搜索的类别
     • action (string) - 靶标特定作用
     • indication (string) - 疾病/病症
     • company (string) - 公司名称
     • drug_name (string) - 药物名称
     • target (string) - 药物靶标
     • technology (string) - 药物技术
   • 返回：包含匹配的分类术语的 JSON 响应

3. get_drug

   • 返回给定标识符的整个药物记录，包含所有可用字段
   • 必需输入：
     • id (string) - 药物标识符
   • 返回：包含完整药物记录的 JSON 响应

4. get_drug_swot

   • 返回补充所选药物记录的 SWOT 分析
   • 必需输入：
     • id (string) - 药物标识符
   • 返回：包含药物 SWOT 分析的 JSON 响应

5. get_drug_financial

   • 返回财务评论和数据（实际销售额和一致预测）
   • 必需输入：
     • id (string) - 药物标识符
   • 返回：包含财务数据和评论的 JSON 响应

6. get_company

   • 返回给定标识符的整个公司记录，包含所有可用字段
   • 必需输入：
     • id (string) - 公司标识符
   • 返回：包含完整公司记录的 JSON 响应

7. search_companies

   • 在 Cortellis 数据库中搜索公司
   • 可选输入：
     • query (string) - 原始搜索查询
     • company_name (string) - 要搜索的公司名称
     • hq_country (string) - 公司总部所在国家/地区
     • deals_count (string) - 公司作为委托人/合作伙伴的所有不同交易的计数
       • 格式：'<20' 表示少于 20 笔交易
       • 格式：'20' 或 '>20' 表示大于 20 笔交易（默认行为）
     • indications (string) - 前 10 个适应症术语
     • actions (string) - 前 10 个基于靶标的作用术语
     • technologies (string) - 前 10 个技术术语
     • company_size (string) - 基于市值（单位：十亿美元）的公司规模
       • 格式：'<2' 表示小于 20 亿美元
       • 格式：'2' 或 '>2' 表示大于 20 亿美元（默认行为）
     • status (string) - 关联药物的最高状态
     • offset (number) - 用于分页
   • 返回：包含公司信息的 JSON 响应

功能

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

HTTP API 端点

在 HTTP 模式下运行 (USE_HTTP=true) 时，可以使用以下 REST 端点：

1. POST /search_drugs

   • 搜索药物，带有可选过滤器
   • Body：包含搜索参数的 JSON 对象（请参阅 search_drugs 工具输入）

2. POST /explore_ontology

   • 搜索分类术语
   • Body：包含搜索参数的 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

   • 搜索公司，带有可选过滤器
   • Body：包含搜索参数的 JSON 对象（请参阅 search_companies 工具输入）

设置

环境变量

服务器需要 Cortellis API 凭据：

CORTELLIS_USERNAME=您的用户名
CORTELLIS_PASSWORD=您的密码

在 Claude Desktop 上安装

在开始之前，请确保您的桌面上安装了 Node.js，以便 npx 正常工作。

1. 转到：Settings > Developer > Edit Config（设置 > 开发者 > 编辑配置）

2. 将以下内容添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "cortellis": {
      "command": "npx",
      "args": [
        "-y",
        "@uh-joan/cortellis-mcp-server"
      ],
      "env": {
        "CORTELLIS_USERNAME": "您的用户名",
        "CORTELLIS_PASSWORD": "您的密码"
      }
    }
  }
}

3. 重新启动 Claude Desktop 并开始探索药物研发数据！

构建（供开发者使用）

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

对于本地开发：

# 复制示例环境变量文件
cp .env.example .env

# 使用您的凭据编辑 .env
vim .env  # 或使用您喜欢的编辑器

# 启动服务器
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 的更多信息，请访问 Clarivate 的 Cortellis 页面。

本项目与 Clarivate Analytics 无关，未经 Clarivate Analytics 认可或赞助。 所有产品名称、徽标和品牌均为其各自所有者的财产。

贡献

欢迎贡献！ 请随时提交 Pull Request。 对于重大更改，请先打开一个 issue，讨论您想要更改的内容。

版本控制

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