mcp-pocket

🚀 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 许可证。