MCP Pocket 使用说明

项目简介

MCP Pocket 是一个基于 Model Context Protocol (MCP) 的服务器,它充当 LLM 客户端(如 Claude Desktop)与 Pocket (稍后阅读) 服务之间的桥梁。通过 MCP Pocket,LLM 客户端可以访问用户在 Pocket 中保存的文章,从而扩展其上下文理解和信息检索能力。

主要功能点

  • 获取 Pocket 文章列表: 允许 LLM 客户端请求并获取用户在 Pocket 中保存的未读文章列表,包括文章标题、URL 和摘要信息。
  • 标记文章为已读: 支持 LLM 客户端将指定的 Pocket 文章标记为已读状态,方便用户管理 Pocket 中的内容。

安装步骤

  1. 安装 Node.js: 确保您的系统已安装 Node.js 运行环境。推荐使用 'brew install node' 命令进行安装。
  2. 克隆仓库: 将 MCP Pocket 仓库克隆到本地:
    git clone https://github.com/kazuph/mcp-pocket.git
    cd mcp-pocket
  3. 安装依赖: 在项目目录下运行 npm 命令安装项目依赖:
    npm install

服务器配置

要将 MCP Pocket 服务器配置到 MCP 客户端,您需要修改 MCP 客户端的配置文件。以 Claude Desktop 为例,您需要编辑 'claude_desktop_config.json' 文件。

在 'mcpServers' 字段下添加 'pocket' 服务器配置,并填入您的 Pocket API 凭据。您需要将 'your-pocket-consumer-key' 和 'your-pocket-access-token' 替换为您在 Pocket 开发者平台 创建应用后获得的 Consumer Key 和 Access Token。

{
  "mcpServers": {
    "pocket": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-pocket"],
      "env": {
        "POCKET_CONSUMER_KEY": "your-pocket-consumer-key",  // 替换为你的 Pocket Consumer Key
        "POCKET_ACCESS_TOKEN": "your-pocket-access-token"   // 替换为你的 Pocket Access Token
      }
    }
  }
}

基本使用方法

配置完成后,MCP 客户端即可连接到 MCP Pocket 服务器。客户端可以通过调用以下工具来使用 Pocket 功能:

  • 'pocket_get_articles': 获取 Pocket 中保存的文章列表。客户端可以传递 'count' 参数 (可选,默认为 20,最大 20) 来指定获取的文章数量。
  • 'pocket_mark_as_read': 将指定 item ID 的 Pocket 文章标记为已读。客户端需要传递 'itemId' 参数,即要标记为已读的文章的 ID。

具体工具的调用方式和参数传递方法,请参考您使用的 MCP 客户端的文档或界面操作说明。

信息

分类

网页与API