使用说明

项目简介

cosense-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 cosen.se 网站上的项目页面作为资源暴露给支持 MCP 协议的客户端，例如 Claude。通过此服务器，Claude 可以检索和读取 cosen.se 上的页面内容，从而扩展其知识库和信息获取能力。

主要功能点

资源访问: 将 cosen.se 网站上指定项目 (Project) 的页面作为 MCP 资源进行托管和管理。客户端可以列出项目中的所有页面，并读取特定页面的内容。
工具集成: 提供 'get_page' 和 'list_pages' 两个工具，允许客户端通过调用工具的方式，更灵活地检索和获取 cosen.se 上的页面信息。
- 'get_page': 根据页面标题获取指定页面的详细内容。
- 'list_pages': 列出当前项目中的所有页面标题。

安装步骤

克隆仓库:

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

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

服务器配置

要将此 MCP 服务器与 Claude Desktop 等 MCP 客户端配合使用，您需要配置客户端的 MCP 服务器设置。以 Claude Desktop 为例，您需要编辑配置文件（路径见 'README.md'）：

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

在 'mcpServers' 字段中添加 'cosense-mcp-server' 的配置信息。以下是一个配置示例，请根据您的实际安装路径修改 'args' 中的路径：

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/funwarioisii_cosense-mcp-server/build/index.js"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name"
        // "COSENSE_SID": "your_sid" // 如果要访问私有项目，请设置 COSENSE_SID
      }
    }
  }
}

配置参数说明:

'server name': 'cosense-mcp-server' (服务器名称，客户端用于标识和调用)
'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
'args': '["/path/to/funwarioisii_cosense-mcp-server/build/index.js"]' (启动命令的参数，指向构建后的服务器入口文件 'index.js'，请将 '/path/to/funwarioisii_cosense-mcp-server' 替换为您的实际仓库路径)
'env': 环境变量配置
- 'COSENSE_PROJECT_NAME': 必需。您要访问的 cosen.se 项目名称。请替换 '"your_project_name"' 为您的项目名称。
- 'COSENSE_SID': 可选。如果您的 cosen.se 项目是私有的，您需要设置 'COSENSE_SID' 来进行身份验证。

基本使用方法

配置完成后，启动 Claude Desktop 或其他 MCP 客户端。客户端应该能够检测到 'cosense-mcp-server' 并与之建立连接。

您可以在 Claude 的对话中使用以下方式来利用此 MCP 服务器的功能：

列出页面: 可以使用 '@list_pages' 工具来获取项目中的页面列表。例如，在 Claude 中输入 '@list_pages'。
获取页面内容: 可以使用 '@get_page' 工具并指定 'pageTitle' 参数来获取特定页面的内容。例如，要获取标题为 "Example Page" 的页面内容，可以在 Claude 中输入 '@get_page pageTitle="Example Page"'。

Claude 将会调用 'cosense-mcp-server' 提供的工具，并将返回的页面信息用于对话上下文中。

关键词