Connapse MCP 服务器

关键词

知识管理向量检索外部工具JSON-RPC云端集成

使用说明（简明指南，便于快速理解与部署）

  • 项目简介

    • Connapse MCP 服务器是在同一个系统内实现的 MCP 服务端组件，旨在以标准化方式向大语言模型客户端提供知识资源、可执行工具以及可定制的提示模板等上下文信息。它通过 JSON-RPC 与客户端通信，并在服务器端处理会话、能力声明，以及跨传输协议的适配。

  • 主要功能点

    • 资源管理与数据访问：托管和管理知识资源、文档、文件等，支持按项目/容器分组。
    • 工具注册与调用：提供可被 LLM 调用的外部功能入口（Tools），实现工具能力的暴露。
    • Prompt 模板定义与渲染：定义与渲染用于 LLM 交互的 Prompt 模板，支持可定制的对话模式。
    • JSON-RPC 通信：服务器端接收客户端的 JSON-RPC 请求，返回结构化的 JSON-RPC 响应。
    • 会话与能力声明：服务器端管理并暴露服务能力，支持鉴权、会话与访问控制。
    • 多传输协议支持：如 Stdio、SSE、WebSocket 等传输场景下的上下文服务能力。
    • 集成与扩展：与 Claude Desktop 等 MCP 客户端集成，便于在桌面环境中使用 Agent API Key 进行鉴权。

  • 安装与运行步骤（简化版）

    • 搭建依赖环境：确保服务器运行环境具备 .NET 10+, PostgreSQL、对象存储等所需组件（若使用仓库提供的 Docker Compose 方案，请参照官方文档中的快速开始）。
    • 构建与启动：按照仓库内的部署指导，启动后端应用，确保 MCP 路径 /mcp 对外可用。
    • 启动后端后，MCP 客户端可通过 /mcp 端点与 MCP 服务器进行交互，进行初始化、资源读取、工具调用等操作。

  • 服务器配置（MCP 客户端所需的配置信息） 说明：MCP 客户端（如 Claude Desktop）在连接 MCP 服务器时需要一个配置项来指向 MCP 服务器。这部分配置采用 JSON 格式，包含服务器名称、启动命令及参数。客户端本身通常并不需要直接修改服务器端实现代码，只需提供正确的连接信息即可。

    • serverName: Connapse MCP 服务器
    • command: dotnet
    • args: ["Connapse.Web.dll", "--urls", "http://0.0.0.0:5001"]
    • 说明：以上为示例，具体可用的执行命令和参数需结合实际部署产物（发布后的可执行文件/程序集名、端口、启动参数等）进行调整。MCP 客户端将通过服务器地址（如 http://<host>:5001/mcp）与 MCP 服务端进行 JSON-RPC 通信。若在容器化环境中运行，请将端口与主机暴露设置匹配。

  • 基本使用方法

    • 在 Claude Desktop 中配置 MCP 服务端连接，提供服务器地址与鉴权方式（如 Agent API Key）。
    • 使用 MCP 提供的资源与工具能力，在对话过程中让 LLM 调用外部工具、读取资源、获取并渲染 Prompt 模板。
    • 若需自定义拓展，请在服务端实现中注册新的 Resources/Tools/Prompts，并通过 JSON-RPC 接口对外暴露。

  • 运行与集成要点

    • MCP 服务端固件通常集成在后端应用中，因此部署时需确保后端应用的 MCP 路径对外可访问。
    • 重点关注身份鉴权、API Key、以及对 Claude Desktop 等 MCP 客户端的兼容性。文档中提及的工具集合（如 container_create、container_list、upload_file、search_knowledge 等）可用于测试集成。

服务器信息

访问项目