返回 MCP 目录
public公开dns本地运行

mcp-pocket

一个连接Claude Desktop与Pocket API的MCP服务,用于获取和管理保存的文章

article

README

🚀 MCP Pocket 中文指南

MCP Pocket 是一个连接器,它允许 Claude Desktop(或其他 MCP 客户端)从 Pocket API 获取您保存的文章,为信息获取提供便利。

🚀 快速开始

先决条件

  • Node.js(可通过 brew install node 进行安装)
  • Claude Desktop(可从 https://claude.ai/desktop 下载安装)
  • Pocket API 凭证

配置步骤

  1. 修改您的 Claude Desktop 配置文件,该文件位于:

    ~/Library/Application\ 支持/Claude/claude_desktop_config.json
    

    您可以通过以下步骤轻松找到此文件:

    1. 打开 Claude Desktop。
    2. 点击菜单栏中的“Claude”。
    3. 点击“设置”。
    4. 点击“开发者”。

    如果您没有此配置文件,可以在该位置创建一个空文件。 添加以下内容到配置文件中,并替换为您自己的凭证:

    {
      "mcpServers": {
        "pocket": {
          "command": "npx",
          "args": ["-y", "@kazuph/mcp-pocket"],
          "env": {
            "POCKET_CONSUMER_KEY": "your-pocket-consumer-key",
            "POCKET_ACCESS_TOKEN": "your-pocket-access-token"
          }
        }
      }
    }
    

📦 安装指南

开发环境设置

  1. 克隆此仓库并安装依赖项:
    git clone https://github.com/kazuph/mcp-pocket.git
    cd mcp-pocket
    npm install
    
  2. 用于开发,请使用以下配置:
    {
      "mcpServers": {
        "pocket": {
          "command": "npx",
          "args": ["tsx", "/path/to/mcp-pocket/index.ts"],
          "env": {
            "POCKET_CONSUMER_KEY": "your-pocket-consumer-key",
            "POCKET_ACCESS_TOKEN": "your-pocket-access-token"
          }
        }
      }
    }
    

开发命令

# 构建 TypeScript
npm run build

# 开发模式(实时监控)
npm run watch

# 发布到 npm
npm login
npm publish

💻 使用示例

在 Claude Desktop 中,以下 MCP 工具将可用:

  • pocket_get_articles:从 Pocket API 获取您的保存文章。返回每个文章的标题、URL 和摘录。
  • pocket_mark_as_read:使用其项目 ID 在您的 Pocket 账户中标记特定文章为已读(存档)。

📚 详细文档

获取 Pocket API 凭证

有关如何获取 Pocket API 凭证的详细说明,请参阅 问题 #2。 简要步骤如下:

  1. Pocket 开发者控制台 创建新应用程序。
  2. 遵循身份验证流程以获取您的消费者密钥和访问令牌。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端