使用说明

项目简介

cosense-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将 cosense 知识库的内容以资源和工具的形式提供给 LLM 客户端。通过此服务器，LLM 可以检索 cosense 页面内容并利用相关工具进行交互，从而增强 LLM 的上下文理解和知识获取能力。

主要功能点

资源管理: 将 cosense 知识库中的页面作为 MCP 资源进行管理，允许 LLM 客户端通过标准 MCP 协议访问页面内容。
页面检索工具 (get_page): 提供 'get_page' 工具，允许 LLM 客户端根据页面标题检索并获取指定的 cosense 页面内容。
页面列表工具 (list_pages): 提供 'list_pages' 工具，允许 LLM 客户端获取 cosense 知识库中所有页面的标题列表。

安装步骤

克隆仓库

git clone https://github.com/MCP-Mirror/yosider_cosense-mcp-server.git
cd yosider_cosense-mcp-server

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要配置客户端以连接到此服务器。以下是 Claude Desktop 的配置示例，您需要将其添加到 Claude Desktop 的配置文件中。请根据您的实际路径修改 'command' 和 'args' 中的路径。

Claude Desktop 配置文件路径：

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容 (JSON 格式):

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/cosense-mcp-server/build/index.js"], // 将 "/path/to/cosense-mcp-server" 替换为克隆仓库的实际路径
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name" // 必须设置：您的 cosense 项目名称
        // "COSENSE_SID": "your_sid" // 可选：如果您的 cosense 项目是私有的，则需要设置 COSENSE_SID
      }
    }
  }
}

配置参数说明：

'command': 启动服务器的命令，这里使用 'node' 表示使用 Node.js 运行。
'args': 启动命令的参数，指向构建后的服务器入口文件 'build/index.js'。请务必将 '/path/to/cosense-mcp-server' 替换为您克隆 'cosense-mcp-server' 仓库的实际绝对路径。
'env': 环境变量配置。
- 'COSENSE_PROJECT_NAME': 必须设置，指定您要访问的 cosense 项目名称。请替换 '"your_project_name"' 为您的实际项目名称。
- 'COSENSE_SID': 可选，如果您的 cosense 项目是私有的，您需要设置 'COSENSE_SID' 环境变量以进行身份验证。请替换 '"your_sid"' 为您的实际 SID。

基本使用方法

配置完成后，MCP 客户端将能够连接到此服务器。客户端可以通过 MCP 协议发送请求来：

列出资源 (ListResources): 获取 cosense 服务器提供的页面资源列表。
读取资源 (ReadResource): 根据资源的 URI 读取指定的 cosense 页面内容。
列出工具 (ListTools): 获取服务器提供的工具列表，包括 'get_page' 和 'list_pages'。
调用工具 (CallTool):
- 调用 'get_page' 工具并传入 'pageTitle' 参数，以检索指定标题的 cosense 页面内容。
- 调用 'list_pages' 工具，以获取 cosense 知识库中所有页面的标题列表。

客户端的具体使用方式请参考您使用的 MCP 客户端的文档。

关键词