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\ Support/Claude/claude_desktop_config.json

Claude Desktop のメニューから簡単に開けます。

1. Claude Desktop を開きます
2. Mac のメニューバーで Claude をクリックします
3. 「Settings」をクリックします
4. 「Developer」をクリックします

この設定ファイルがない場合は、この場所に空のファイルを作成できます。

認証情報を自分のものに置き換えて、以下を設定ファイルに追加します。

{
  "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"
      }
    }
  }
}

開発コマンド

# Build TypeScript
npm run build

# Watch mode for development
npm run watch

# Publish to npm
npm login
npm publish

利用可能なコマンド

以下の MCP ツールを Claude Desktop で利用できます。

• pocket_get_articles：Pocket API から保存済みの記事を取得します。各記事のタイトル、URL、抜粋を返します。
• pocket_mark_as_read：項目 ID を使用して、Pocket アカウント内の特定の記事を既読（アーカイブ済み）にします。

Pocket API の認証情報を取得する

Pocket API の認証情報を取得する詳しい手順については、Issue #2 を参照してください。

簡単な手順：

1. Pocket Developer Portal で新しいアプリを作成します
2. 認証手順に従って、Consumer Key と Access Token を取得します

ライセンス

MIT