Kortx MCP

短

](https://www.npmjs.com/package/@effatico/kortx-mcp)   ](https://nodejs.org)

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

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)用于视觉生成和编辑。

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

______________________________________________________________________

亮点

• 七个咨询工具加上一个批处理运行器，涵盖规划、备选方案、复制改进、调试、专家咨询、研究和图像工作流程。
• 用于引用支持的答案和图像搜索的困惑集成（需要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

1. 将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

备注

完整参考： 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是必需的。

______________________________________________________________________

文档

• 入门指南
• 集成指南
• api参考
• 故障排除
• 示例

______________________________________________________________________

贡献与支持

• 贡献指南
• 安全策略
• 问题追踪
• 电子邮件

______________________________________________________________________

许可证

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