environment-config

环境配置和部署规范

环境变量配置

必需环境变量

# .env 文件配置
PUBMED_API_KEY=your_ncbi_api_key_here
[email protected]
ABSTRACT_MODE=quick  # 或 deep
FULLTEXT_MODE=disabled  # disabled, enabled, auto

代理配置环境变量

# 代理配置（可选）
HTTP_PROXY=http://proxy.example.com:8080
HTTPS_PROXY=https://proxy.example.com:8080
# 或者使用小写（兼容性）
http_proxy=http://proxy.example.com:8080
https_proxy=https://proxy.example.com:8080

环境变量说明

• PUBMED_API_KEY: NCBI API密钥，从 NCBI API Key Management 获取
• PUBMED_EMAIL: 邮箱地址，用于PubMed API调用标识
• ABSTRACT_MODE: 摘要模式
  • quick: 1500字符，快速检索
  • deep: 6000字符，深度检索（需要≥120k tokens上下文）
• FULLTEXT_MODE: 全文模式
  • disabled: 禁用全文功能（默认）
  • enabled: 启用全文检测，手动下载
  • auto: 启用全文检测，自动下载可用的OA论文
• HTTP_PROXY / HTTPS_PROXY: 代理服务器地址
  • 支持HTTP和HTTPS代理
  • 格式：http://proxy.example.com:8080
  • 如果不指定协议，默认使用HTTP
  • 支持认证：http://username:[email protected]:8080

MCP客户端配置

1. Cline (VS Code Extension)

{
  "mcpServers": {
    "pubmed-data-server": {
      "command": "node",
      "args": ["./src/index.js"],
      "cwd": "完整路径/to/mcp-pubmed-server",
      "env": {
        "PUBMED_API_KEY": "你的API密钥",
        "PUBMED_EMAIL": "你的邮箱地址",
        "ABSTRACT_MODE": "deep",
        "FULLTEXT_MODE": "enabled",
        "HTTP_PROXY": "http://proxy.example.com:8080",
        "HTTPS_PROXY": "https://proxy.example.com:8080"
      }
    }
  }
}

2. Cherry Studio (Windows)

{
  "mcpServers": {
    "pubmed-data-server": {
      "name": "pubmed-data-server",
      "type": "stdio",
      "isActive": true,
      "command": "node",
      "args": ["Y:/software/mcp-pubmed-server/src/index.js"],
      "env": {
        "PUBMED_API_KEY": "你的API密钥",
        "PUBMED_EMAIL": "你的邮箱地址",
        "ABSTRACT_MODE": "deep",
        "FULLTEXT_MODE": "enabled",
        "HTTP_PROXY": "http://proxy.example.com:8080",
        "HTTPS_PROXY": "https://proxy.example.com:8080"
      }
    }
  }
}