Elnora MCP Server

Elnora MCP 服务

通过 Model Context Protocol，将 AI Agent 连接到 Elnora 生物实验方案优化平台。

什么是 Elnora？

Elnora 是一个由 AI 驱动的平台，可帮助研究人员为湿实验生成、优化和管理生物实验方案。借助此 MCP 服务，你可以直接通过 Claude Code、Cursor、VS Code、Codex 和 ChatGPT 等 AI 编码助手与 Elnora 交互。

快速开始

将 Elnora MCP 服务添加到你的 AI 客户端。无需安装——只需指定远程 URL。

要在编码 Agent 中进行设置？ 请参阅 INSTALL_FOR_AGENTS.md，其中包含逐步说明、 可自行验证的操作手册（客户端配置、身份验证和冒烟测试）。

Claude Code

claude mcp add elnora --transport http --scope user https://mcp.elnora.ai/mcp

安装范围：

范围	标志	存储位置	适用场景
用户	--scope user	~/.claude.json	在你的所有项目中可用（推荐）
本地	--scope local	当前项目配置	用于单个项目（省略时的默认值）
项目	--scope project	项目根目录中的 .mcp.json	通过版本控制与团队共享

Cursor

将其添加到 Cursor MCP 设置中（Settings > MCP Servers）：

{
  "mcpServers": {
    "elnora": {
      "url": "https://mcp.elnora.ai/mcp"
    }
  }
}

VS Code（Copilot）

将其添加到你的 .vscode/mcp.json：

{
  "servers": {
    "elnora": {
      "type": "http",
      "url": "https://mcp.elnora.ai/mcp"
    }
  }
}

Codex

codex --mcp-config mcp.json

使用 mcp.json：

{
  "mcpServers": {
    "elnora": {
      "url": "https://mcp.elnora.ai/mcp"
    }
  }
}

ChatGPT

在 ChatGPT 设置中将其添加为远程 MCP 服务，使用 URL https://mcp.elnora.ai/mcp。

---

首次连接时，会打开浏览器窗口进行 OAuth 登录。后续请求将自动使用已签发的令牌。

身份验证

OAuth 2.1（推荐）

大多数 MCP 客户端会自动处理 OAuth。首次连接时：

1. 浏览器窗口会打开以供登录
2. 如果应用是托管式（Web）连接器，系统会显示同意页面，说明哪个应用正在请求访问权限，以及授权码将发送到哪里——请检查并批准
3. 使用你的 Elnora 账户进行身份验证
4. 客户端会收到令牌，并在后续请求中使用该令牌

无需手动配置。

API 密钥

在你的 Elnora 控制面板中创建 API 密钥，并通过 X-API-Key 标头传递：

{
  "mcpServers": {
    "elnora": {
      "url": "https://mcp.elnora.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

如果你的客户端只提供单个 bearer/token 字段，也可以改用 Authorization: Bearer YOUR_API_KEY 传递同一密钥——服务接受通过任一标头传入的 Elnora API 密钥。

安全最佳实践：

• 切勿将 API 密钥提交到版本控制中
• 使用环境变量或密钥管理器
• 定期通过 Elnora 控制面板轮换密钥
• 尽可能使用 OAuth——它会自动处理令牌刷新

功能

涵盖 15 个类别的 74 个工具。所有工具都可以通过 MCP 客户端的工具列表发现。

类别	工具数	可执行的操作
方案	1	根据自然语言描述生成优化的生物实验方案
任务	6	创建对话线程、发送消息、获取 AI 回复
消息	1	在任务上下文中与 Elnora 的 AI 聊天
文件	18	上传、下载、创建版本、派生和管理方案文件
项目	10	创建项目并管理团队成员
组织	13	组织设置、账单、邀请成员
文件夹	5	将文件整理到嵌套文件夹结构中
库	5	访问组织共享的方案库
搜索	3	对任务、文件和所有资源进行全文搜索
API 密钥	3	创建和管理个人 API 密钥
审计	1	查询组织审计日志
账户	4	管理用户个人资料和协议
反馈	1	提交平台反馈
功能标志	2	检查功能可用性
健康状态	1	验证 API 连通性

示例

生成生物实验方案

“使用 Elnora 生成一份 HEK 293 细胞维护方案”

助手会调用 elnora_generate_protocol，根据你的描述生成并返回方案。对于复杂请求，这可能需要 30-120s。

搜索和读取文件

“列出我在 Elnora 中的文件，然后展示最近一份方案的内容”

管理任务

“显示我在 Elnora 中正在进行的任务，并获取最新任务的消息”

整理项目

“创建一个名为 ‘Q3 Assays’ 的新项目，为每个细胞系添加一个文件夹，并邀请 [email protected]”

故障排除

错误	原因	解决方案
401 Unauthorized	缺少或过期的令牌	通过 OAuth 重新认证，或检查你的 API 密钥
403 Forbidden	权限不足	确认你的账户有权访问所请求的资源
408 / Timeout	操作复杂，耗时过长	方案生成最长可能需要 120s——请重试或简化请求
Connection refused	服务无法访问	检查你的互联网连接；确认 https://mcp.elnora.ai/health 可以访问

如果问题持续存在，请提交 GitHub 问题。

安全

我们高度重视安全。如果你发现漏洞，请负责任地报告——请参阅我们的安全政策。

贡献

贡献指南请参阅 CONTRIBUTING.md。

更新日志

版本历史请参阅 CHANGELOG.md。

许可证

Apache License 2.0

支持

• 错误报告和功能请求： GitHub Issues
• 账户和账单： [email protected]
• 安全漏洞： [email protected]