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 (字符串) - 原始搜索查询
     • company (字符串) - 开发药物的公司
     • indication (字符串) - 活性适应症（例如，肥胖症）
     • action (字符串) - 靶标特定作用（例如，胰高血糖素）
     • phase (字符串) - 研发状态：
       • 支持短格式和描述性格式：
         • 短格式：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: 1-3 期临床 (Phase 1-3 Clinical)
         • PR: 预注册 (Pre-registration)
         • R: 已注册 (Registered)
         • L: 已上市 (Launched)
         • OL: 许可转让 (Outlicensed)
         • NDR: 无研发报告 (No Development Reported)
         • DX: 已停止 (Discontinued)
         • W: 已撤回 (Withdrawn)
     • 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 (字符串) - 前 10 个技术术语
     • company_size (字符串) - 基于市值（单位：十亿美元）的公司规模
       • 格式：'<2' 表示小于 20 亿美元
       • 格式：'2' 或 '>2' 表示大于 20 亿美元（默认行为）
     • status (字符串) - 关联药物的最高状态
     • offset (数字) - 用于分页
   • 返回：包含公司信息的 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 进行版本控制。 有关可用版本，请参阅 此存储库上的标签。