项目简介

Cosense MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端,它将 Cosense 平台上的项目页面以资源和工具的形式提供给 LLM 客户端。通过此服务器,LLM 可以访问 Cosense 平台上的知识库内容,用于问答、内容生成等任务。此服务器实现了 MCP 协议,能够与任何兼容 MCP 协议的 LLM 客户端进行通信。

主要功能点

  • 资源管理: 将 Cosense 项目中的页面列表作为资源提供给 LLM 客户端,方便客户端发现和访问。
  • 数据访问: 允许 LLM 客户端通过资源 URI 读取 Cosense 页面的内容。
  • 工具执行: 提供了两个工具:
    • 'get_page': 根据页面标题获取指定 Cosense 页面的详细内容。
    • 'list_pages': 获取 Cosense 项目中所有页面的标题列表。
  • Cosense 集成: 通过调用 cosen.se 的 API 接口获取页面数据,支持公开和私有项目(通过 'COSENSE_SID' 配置)。

安装步骤

  1. 克隆仓库到本地:
    git clone https://github.com/funwarioisii/cosense-mcp-server.git
  2. 进入项目目录:
    cd cosense-mcp-server
  3. 安装依赖:
    npm install
  4. 构建服务器:
    npm run build

服务器配置

要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),您需要提供服务器的启动命令。以下是配置示例,您需要根据实际情况修改路径和项目名称。

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/cosense-mcp-server/build/index.js"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name"  // 替换为您的 Cosense 项目名称
        // "COSENSE_SID": "your_sid"  // 可选:如果您的 Cosense 项目是私有的,请设置此项
      }
    }
  }
}

配置参数说明:

  • 'command': 启动服务器的命令,这里使用 'node'。
  • 'args': 启动命令的参数,指向构建后的 'index.js' 文件路径。请将 '/path/to/cosense-mcp-server/build/index.js' 替换为实际路径。
  • 'env': 环境变量配置。
    • 'COSENSE_PROJECT_NAME': 必填,您的 Cosense 项目名称。
    • 'COSENSE_SID': 可选,如果您的 Cosense 项目是私有的,需要设置此项以进行身份验证。

基本使用方法

  1. 确保已将上述服务器配置添加到您的 MCP 客户端。
  2. 启动您的 MCP 客户端,客户端应该会自动连接到 Cosense MCP 服务器。
  3. 在 LLM 客户端中,您应该能够:
    • 发现来自 Cosense 项目的资源(页面标题列表)。
    • 通过资源 URI(例如 'cosense:///页面标题')读取 Cosense 页面的内容。
    • 使用 'get_page' 工具,输入页面标题来获取页面内容。
    • 使用 'list_pages' 工具,获取当前 Cosense 项目的所有页面标题列表。

信息

分类

网页与API