ThoughtLab MCP Server

关键词

知识图谱LangGraph向量检索Claude DesktopAI 工具集成

使用说明（Markdown 格式）

  • 项目简介

    • ThoughtLab MCP Server 是 ThoughtLab 项目的一部分，实现基于 MCP 的后端服务器。它把资源、工具和提示模板以统一的 MCP 接口暴露，供 MCP 客户端（如 Claude Desktop）通过 JSON-RPC 调用，完成资源管理、工具执行、以及提示模板的渲染与渲染结果处理。

  • 主要功能点

    • MCP 服务暴露：为客户端提供标准化的 MCP 调用入口，用于查询资源、执行工具、获取提示等能力。
    • 工具注册与执行：通过 Tool Registry 与 MCP 工具包装，支持多种工具的同步/异步执行模式，以及必要时的管理员权限门控（危险工具需管理员开启）。
    • 资源与工具管理：统一管理工具元数据、MCP 注册信息，以及健康检查等运维能力。
    • 跨进程/传输协议支持：设计之初便考虑到 MCP 的传输适应性，支持通过标准化的 MCP 流程与 Claude Desktop 进行交互。
    • 集成入口与示例：提供入口脚本，可直接作为独立服务启动，也可作为 FastAPI 应用的一部分挂载在 /mcp 路径下，与后端现有 API 及 LangGraph/AI 流程协同工作。

  • 安装步骤

    • 获取代码：将仓库克隆到本地或服务器。
    • 环境准备：确保 Python 3.11 及以上环境可用，安装所需依赖（通常通过项目的 requirements.txt/poetry 等完成）。
    • 环境变量（关键，按需启用 AI 功能与管理员模式）：
      • THOUGHTLAB_OPENAI_API_KEY：用于 OpenAI API 的访问密钥，启用 AI 相关工具时需要。
      • THOUGHTLAB_MCP_ADMIN_MODE：若设为 true，将开启危险工具的管理员模式许可。
    • 启动方式：
      • 直接运行入口脚本：python backend/mcp_server.py
      • 或将 MCP 服务器作为子应用挂载到一个 FastAPI 应用下，使用创建的 MCP 服务器实例通过 http_app() 挂载到 /mcp。
    • 依赖与注册：
      • MCP 服务自动注册 ThoughtLab 的工具定义，基于 Tool Registry 和 Tool Definition 配置进行注册。
      • 启动后，服务器会暴露一个健康检查工具，方便运维监控状态。

  • 服务器配置（MCP 客户端配置示例，JSON 格式） 说明：以下配置用于 MCP 客户端连接和启动 MCP 服务器。若语言客户端需要以 JSON 指令来启动和连接 MCP 服务器，该配置可直接用于客户端读取并执行相应连接动作。字段含义在括号中给出注释。 { "server_name": "ThoughtLab", "command": "python", "args": ["backend/mcp_server.py"], "transport": "stdio", "description": "ThoughtLab MCP 服务器（用于 Claude Desktop 及其他 MCP 客户端）", "admin_mode": false }

    • server_name: MCP 服务器的名称，客户端在显示、日志等场景会使用到该名称。
    • command: 启动 MCP 服务器所用的命令，此处为 python。
    • args: 启动命令的参数列表，此处为需要执行的脚本路径 backend/mcp_server.py。
    • transport: 指定传输协议，这里使用 stdio（与 Claude Desktop 的默认对接方式相匹配），也可扩展支持 SSE/WebSocket 等传输。
    • description: 给客户端一个简要的服务器描述，便于在多个可用服务器时做区分。
    • admin_mode: 是否开启管理员模式，允许危险工具在 MCP 服务中可用。

  • 基本使用方法

    • 启动与连接
      • 确保已正确配置 API_KEY、管理员模式和相关后端服务（如 AI、Neo4j、Redis 等）。
      • 在服务器上运行入口脚本，启动 ThoughtLab MCP Server。
      • 在 MCP 客户端（如 Claude Desktop）配置一个 MCP 连接，使用以上 JSON 配置中的 server_name、command、args 和 stdio 传输参数完成初次连接。
    • 客户端操作
      • 通过 MCP 客户端执行相应的工具调用（如 find_related_nodes、summarize_node、summarize_relationship 等）。
      • 客户端可通过健康检查工具确认后端可用性与 AI 配置状态。
    • 管理员模式
      • 如需开启危险工具（如 destructive 的 merge_nodes、reclassify 等），将 THOUGHTLAB_MCP_ADMIN_MODE 设置为 true，并在客户端请求相应工具时遵循管理员确认流程。
    • 日常运维
      • 监控 /health、/tools/capabilities、以及工具的注册与可用性。
      • 如需在 FastAPI 中集成，请将 MCP 服务实例挂载至 /mcp 路径，并确保跨进程通信与安全策略配置妥当。

  • 基本注意事项

    • 该实现将工具定义、注册、以及工具执行包装成 MCP 服务，确保 MCP 客户端可以通过标准的 MCP 路径与后端进行交互。
    • 若后端 AI 功能未配置（缺少 OpenAI API KEY），部分 AI 驱动工具将以降级模式工作或返回友好提示。
    • 管理员模式默认关闭，开启后需确保有合适的权限审查和审计。

  1. 关键词 知识图谱, LangGraph, 辅助工具, 向量检索, Claude Desktop

  2. 分类ID 6

服务器信息

访问项目