AI导哈

AI模型协议服务器

Kortx是一款轻量级的Model Context Protocol（MCP）服务器，为编码助手提供OpenAI GPT-5模型、Perplexity Sonar模型和GPT Image模型的访问，支持文件上下文集成和多种MCP服务器连接。

  • by effatico
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 effatico/kortx-mcp

使用说明

短

快速开始 • 文档 • 示例 • 贡献

Kortx是一款轻量级 模型上下文协议 （MCP）服务器，允许编码副驾驶员访问：

  • OpenAI GPT-5模型(gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-codex, gpt-5.1-2025-11-13, gpt-5.1-codex)具有自动回退功能。
  • 用于实时研究的困惑声纳模型。
  • GPT映像(gpt-image-1)用于视觉生成和编辑。
  • 一个默认的上下文收集器，可以摄取本地文件摘录和可选的连接器 塞雷娜, MCP知识图，以及 CCLSP MCP服务器在运行时。

该服务器附带了结构化日志记录、请求速率限制、响应缓存和作为非root用户运行的强化Docker构建。目前传输仅为stdio（HTTP尚未实现）。

亮点

  • 七个咨询工具加上一个批处理运行器，涵盖规划、备选方案、复制改进、调试、专家咨询、研究和图像工作流程。
  • 开箱即用的基于文件的上下文丰富功能，配备可插拔的MCP连接器 塞雷娜/MCP知识图/CCLSP 如果可用。
  • 用于引用支持的答案和图像搜索的困惑集成（需要API密钥）。
  • 可配置的OpenAI模型、推理努力、冗长和重试行为。
  • 内置速率限制、缓存和可选的审计日志记录，以避免上游API泛滥。
  • Dockerfile使用多阶段构建、npm审计，并以UID/GID 1001运行。

快速开始

  1. 设置凭据 （当前配置需要这两个键）：

    export OPENAI_API_KEY=sk-your-openai-key
export PERPLEXITY_API_KEY=pplx-your-perplexity-key

  2. 将Kortx添加到您的MCP客户端通用配置示例：

    {
  "mcpServers": {
    "kortx-mcp": {
      "command": "npx",
      "args": ["-y", "@effatico/kortx-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "PERPLEXITY_API_KEY": "${PERPLEXITY_API_KEY}"
      }
    }
  }
}

Claude Code、VS Code Copilot、Cursor等特定于客户端的演练可在以下网址获得 文档/集成.

工具概览

  • think-about-plan –对计划进行结构化审查，包括优势、风险和后续问题。
  • suggest-alternative –生成具有权衡和约束的可行替代方案。
  • improve-copy –通过语气、清晰度和可访问性指导来完善技术副本。
  • solve-problem –调试助手，涵盖根本原因分析和补救步骤。
  • consult –与特定领域的人物角色（软件架构、安全性、性能、数据库、devops、前端、后端、ai ml、通用）进行专家咨询。
  • search-content –困惑支持的网络/学术/SEC搜索，包括引用和可选图像。
  • create-visual 基于GPT图像的生成器/编辑器；搜索模式将困惑重新用于视觉灵感。
  • batch-consult –并行运行多个工具调用并返回聚合结果。

每个咨询工具都接受一个可选 preferredModelOpenAI客户端回退 gpt-5.1-2025-11-13 → gpt-5.1-codex → gpt-5 → gpt-5-mini → gpt-5-nano 故障时自动。

配置要点

最小环境变量：

  • OPENAI_API_KEY –必填
  • PERPLEXITY_API_KEY –必需（通过省略“困惑”集成来禁用 search-content / create-visual 搜索模式（如果您没有密钥）

常见覆盖（参见 .env.example 完整列表）：

# OpenAI behaviour
OPENAI_MODEL=gpt-5-mini        # gpt-5 | gpt-5-mini | gpt-5-nano | gpt-5-codex | gpt-5.1-2025-11-13 | gpt-5.1-codex
OPENAI_REASONING_EFFORT=minimal
OPENAI_VERBOSITY=low
OPENAI_MAX_TOKENS=1024

# Safety & performance
ENABLE_RESPONSE_CACHE=true
CACHE_MAX_SIZE_MB=100
ENABLE_RATE_LIMITING=true
MAX_REQUESTS_PER_HOUR=100

# Context gathering
ENABLE_SERENA=false            # flip to true when a Serena MCP server is reachable
ENABLE_MEMORY=false            # same for MCP Knowledge Graph
ENABLE_CCLSP=false             # same for cclsp
INCLUDE_FILE_CONTENT=true

备注 这 塞雷娜, MCP知识图，以及 CCLSP 连接器是存根，仅当相应的MCP服务器正在运行且可访问时才返回数据。gatherer使用提示中引用的磁盘上文件摘录。

完整参考： docs/configuration.md

码头工人

在本地构建和运行：

docker build -t kortx-mcp .
docker run -i --rm \
  -e OPENAI_API_KEY=$OPENAI_API_KEY \
  -e PERPLEXITY_API_KEY=$PERPLEXITY_API_KEY \
  kortx-mcp

图片：

  • 使用Node.js 22 Alpine
  • 执行 npm audit 构建期间
  • 仅复制已编译的 build/ 人工制品和生产部门
  • 以用户身份运行 nodejs （UID 1001）

编写示例(docker-compose.yml)包括用于使用卷装载的更长寿命运行。

发展

git clone https://github.com/effatico/kortx-mcp.git
cd kortx-mcp
npm install
cp .env.example .env
npm run build
npm run dev

有用的脚本：

  • npm test / npm run test:coverage
  • npm run lint / npm run lint:fix
  • npm run format / npm run format:check
  • npm run inspector –启动MCP检查器进行交互式调试

Node.js≥22.12.0和npm≥9是必需的。

文档

贡献与支持

许可证

MIT© Effati咨询公司。参见 许可证.

相关 MCP