关键词

AI工作空间本地AI工具LLM集成桌面应用自动化上下文服务

项目简介

PageSpace是一款智能工作空间应用，旨在让AI智能体能够直接在用户的项目中与团队协作，进行内容创建、编辑和组织。其桌面版内置了一个MCP（Model Context Protocol）服务管理器，允许用户连接和管理本地的MCP服务器（例如'pagespace-mcp'），并支持远程AI客户端（如Claude Desktop或PageSpace云服务）通过WebSocket协议安全地调用这些本地工具，实现AI对用户工作空间的直接操作。

主要功能点

  • MCP服务器托管: 管理并运行用户本地安装的MCP服务器（例如'pagespace-mcp'），作为其运行环境和代理。
  • JSON-RPC通信: 通过标准I/O（stdin/stdout）与本地MCP服务器进行JSON-RPC通信，以发现工具和执行请求。
  • 工具发现与执行: 发现本地MCP服务器提供的工具，并响应LLM客户端的工具调用请求。
  • WebSocket远程访问: 作为WebSocket服务器端点，允许远程AI客户端（如PageSpace云服务）通过安全连接调用本地管理的工具。
  • 会话与认证管理: 处理JWT认证、挑战-响应机制，确保远程访问的安全性。
  • 配置与状态管理: 提供统一界面和API来配置MCP服务器、查看其运行状态、启动、停止和重启。

安装步骤

  1. 安装PageSpace桌面应用: 从PageSpace GitHub仓库的发布页面下载并安装适用于您操作系统的PageSpace桌面应用（支持macOS, Windows, Linux）。这是运行MCP服务管理功能的基础。
  2. 安装'pagespace-mcp'服务器 (推荐): 'pagespace-mcp' 是一个提供PageSpace特定工具的MCP服务器。打开终端或命令行工具，运行以下命令进行安装： 
    npm install -g pagespace-mcp@latest

服务器配置

MCP客户端需要通过JSON配置来连接和使用PageSpace Desktop的MCP服务。以下是配置示例，您可以在兼容的MCP客户端（如Claude Desktop或Cursor）的设置中添加。请注意，这些客户端会根据此配置启动或连接PageSpace Desktop的MCP服务，并调用其暴露的工具。

{
  "mcpServers": {
    "pagespace": {
      "command": "npx",
      "args": ["-y", "pagespace-mcp@latest"],
      "env": {
        "PAGESPACE_API_URL": "https://www.pagespace.ai",
        "PAGESPACE_AUTH_TOKEN": "your-mcp-token"
      }
    }
  }
}
  • 'mcpServers': 这是一个JSON对象，包含您想要配置的所有MCP服务器。
  • 'pagespace': 这是您为该MCP服务器指定的名称，可以自定义。
  • 'command': 启动MCP服务器进程的命令。对于'pagespace-mcp'，通常是'npx'。
  • 'args': 传递给'command'的命令行参数。'-y pagespace-mcp@latest'表示安装并运行最新版的'pagespace-mcp'。
  • 'env': 启动MCP服务器进程时设置的环境变量。
    • 'PAGESPACE_API_URL': PageSpace云服务的API地址，用于本地MCP服务器与云端同步。
    • 'PAGESPACE_AUTH_TOKEN': 从PageSpace仪表盘获取的MCP认证令牌，用于授权本地服务器访问您的云端工作空间。

基本使用方法

  1. 启动PageSpace桌面应用: 确保PageSpace桌面应用正在运行。
  2. 获取MCP认证令牌: 访问'www.pagespace.ai/dashboard/settings/mcp'获取您的MCP令牌。
  3. 配置MCP客户端: 将上述“服务器配置”中的JSON片段添加到您选择的MCP客户端（如Claude Desktop或Cursor）的MCP设置中，并替换'PAGESPACE_AUTH_TOKEN'为您的实际令牌。
  4. 在AI客户端中调用: 现在，您的AI客户端（如Claude Desktop）可以直接调用PageSpace桌面版管理的工具，例如：
    • "Show me my drives and pages" (查看工作空间结构)
    • "Create a new project structure" (创建项目结构)
    • "Edit line 42 in the requirements document" (直接编辑文档内容)

信息

分类

桌面与硬件

访问项目