MCP 思考服务器使用说明（简体中文）

安装与运行

1. 安装依赖

在项目的根目录下运行以下命令以安装所有必要的依赖：

npm install

2. 运行服务器

启动服务器有三种常用方式：

方式一：使用 npx 启动

直接运行以下命令即可启动服务器：

npx ts-node src/index.ts

方式二：构建并启动

先构建项目，然后启动构建后的文件：

npm run build
npm start

方式三：使用 Docker 容器启动（参见下方 Docker 支持部分）

3. 配置环境变量

以下是服务器运行所需的环境变量及其说明：

错误处理与常见问题

1. "Original draft X not found" 错误

此错误表明无法检索到之前的草稿记录。请确保以下几点：

• 数据库文件路径（通过 MCP_SQLITE_PATH 或默认路径 data/mcp-thought-server.sqlite）正确无误。
• 服务器进程对数据库文件所在的目录和文件具有写入权限。
• 如果怀疑数据库文件损坏，可以尝试删除旧的 .sqlite 文件以重建新的空数据库。但请注意，此操作会导致历史数据丢失。

2. LLM 连贯性检查问题

若启用连贯性检查，请确保以下配置正确：

• COHERENCE_API_KEY：包含有效的 API 密钥。
• COHERENCE_CHECK_MODEL：指定支持结构化 JSON 输出的模型 ID。
• 确保外部 LLM 服务运行正常。

如需禁用连贯性检查，可删除或注释相关环境变量配置。

3. 低置信度评分

可能的原因包括：

• AI 的输出内容与上下文语义不匹配（检查语义相似度评分部分）。
• 启用了连贯性检查但模型输出不连贯。
• 提供给工具的 context 参数不足或定义模糊。

4. 嵌入式模型下载失败

请确保首次运行服务器时具备互联网连接，以便下载必要的嵌入式模型。同时检查缓存目录权限：

npm run download-models

架构概述

MCP 思考服务器基于以下主要组件构建：

• 输入处理模块：负责接收和解析用户请求。
• 上下文管理器：维护当前思考过程的上下文信息。
• 推理引擎：根据上下文生成思考结果并评估置信度。
• 输出适配器：将推理结果格式化为指定输出格式。

Docker 支持

1. 构建镜像

在项目根目录下运行以下命令以构建 Docker 镜像：

docker build -t mcp-thought-server .

2. 运行容器

使用以下命令启动 MCP 思考服务器容器：

基本启动

docker run --name mcp-thought-container -it mcp-thought-server

配置环境变量并绑定端口

docker run --name mcp-thought-container \
    -e LOG_LEVEL=info \
    -e TRANSPORT=http \
    -p 3000:3000 \
    -it mcp-thought-server

3. 停止与删除容器

停止运行中的容器：

docker stop mcp-thought-container

删除已停止的容器：

docker rm mcp-thought-container

附录：环境变量参考

以下是服务器支持的所有环境变量及其详细说明：

如有其他问题或需要进一步帮助，请随时查阅项目文档或联系维护团队。