Hoarder MCP Server

Created By

VTFLAB8 months ago

# hoarder

# mcp

Overview Content Tools Comments

Content

Hoarder MCP Server

Model Context Protocol (MCP) サーバーの実装で、Hoarder API と統合されています。LLMから直接Hoarderのブックマーク、ハイライト、タグ、リストにアクセスすることができます。

機能

ブックマークの取得とフィルタリング
ブックマークの検索
ハイライトの取得
タグの取得
リストの取得
ユーザー統計の取得

必要条件

Node.js 18以上
Hoarder APIアカウントとAPIキー

クイックスタート

GitHubリポジトリから直接実行するには：

# GitHubから直接実行
npx -y github:yourusername/hoarder-mcp-server --stdio

または、ローカルインストール後：

# ローカルインストール
npm install -g github:yourusername/hoarder-mcp-server

# 実行
hoarder-mcp-server --stdio

環境変数は以下の方法で設定できます：

# 環境変数の直接設定
HOARDER_API_URL=https://api.karakeep.app HOARDER_API_KEY=your_api_key npx -y github:yourusername/hoarder-mcp-server --stdio

セットアップ

リポジトリをクローンする：

git clone <repository-url>
cd hoarder-mcp-server

依存関係をインストールする：

npm install

環境変数を設定する：

.env.exampleファイルを.envにコピーし、必要な値を設定します：

cp .env.example .env

.envファイルを編集してAPIキーとURLを設定します：

HOARDER_API_URL=https://api.karakeep.app
HOARDER_API_KEY=your_api_key_here

使用方法

ビルドと実行

# TypeScriptをJavaScriptにコンパイルする
npm run build

# サーバーを起動する
npm start

開発モード

npm run dev

MCPクライアントとの接続

このサーバーは標準的なModel Context Protocol (MCP) クライアントと互換性があります。例えば、Claude.app、Anthropic API、またはカスタムMCPクライアントから接続できます。

Claude.appでの使用方法

Claude.appにアクセスします
右下の「+」ボタンをクリックし、「Add model context」を選択します
「Connect server」を選択し、以下のコマンドを入力します：

npx -y github:yourusername/hoarder-mcp-server --stdio

「Connect」をクリックすると、Claudeが自動的にHoarder APIと接続します
これでClaudeから「Show me my bookmarks」などのプロンプトでHoarderのデータにアクセスできます

Anthropic API経由での使用

import { Anthropic } from "@anthropic-ai/sdk";
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

// MCPクライアントを初期化
const mcp = new Client({ name: "hoarder-api-client", version: "1.0.0" });

// MCPサーバーに接続
const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "github:yourusername/hoarder-mcp-server", "--stdio"],
});

await mcp.connect(transport);

// ツールのリストを取得
const toolsResult = await mcp.listTools();
const tools = toolsResult.tools.map((tool) => ({
  name: tool.name,
  description: tool.description,
  input_schema: tool.inputSchema,
}));

// Anthropic APIでツールを使用
const anthropic = new Anthropic();
const response = await anthropic.messages.create({
  model: "claude-3-opus-20240229",
  max_tokens: 1000,
  messages: [
    {
      role: "user",
      content: "最近のブックマークを5つ表示して、それぞれの内容を要約してください。",
    },
  ],
  tools,
});