hamir

hamir MCP サーバー

hamirとお好みのAIエージェントで、お気に入りのトピックを追いかけましょう。

• 「今日、最も多くの情報源が取り上げているニュースは何ですか？」
• 「The Kyiv Independentは最近、どんな記事を公開しましたか？」
• 「hamirのテクノロジーに関するパックを見せてください。」
• 「これをhamirに保存して、メモを付けてください：金曜日までに読む。」

ツール

いずれもhamirのサーバー上の情報を変更しません。

ツール	戻り値
search	クエリに一致する記事。それぞれにfetchで使うIDが含まれます
fetch	1件の記事：タイトル、情報源、日付、リンク、および許可されている場合は抜粋
search_sources	名前、ウェブサイト、トピックで検索したニュースサイト、雑誌、ブログ
get_source_articles	1つの情報源からの最新記事
todays_coverage	最も多くの情報源が取り上げているニュース
list_packs	hamirが厳選した情報源のパック
get_pack	1つのパックに含まれる情報源
save_articles	最大50件の記事を保存するリンク。アプリで確認すると、メモ付きで保存されます

記事は見出し、情報源、日付、リンクとして返されます。フィード独自の抜粋は、情報源がAIによる要約を許可している場合にのみ含まれます。記事本文は返されず、1回の呼び出しで取得できる結果数には上限があります。

接続

サーバーはhttps://hamir.app/mcpにあります（Streamable HTTP、サインイン不要）。このURLを任意のMCPクライアントに追加してください。

クライアント	方法
ChatGPT	開発者モードを有効にしてから、Plugins → + → サーバーURL、認証なし
Claude（ウェブ版とモバイル版）	Settings → Connectors → Add custom connector、サインイン不要
Claude Code	claude mcp add -t http -s user hamir https://hamir.app/mcp
Codex	codex mcp add hamir --url https://hamir.app/mcp
Cursor、VS Code、Gemini CLI、Zed、その他6つ	docs/clients.md

デスクトップ拡張機能

Claude Desktop用に、このリポジトリではワンクリックでインストールできる拡張機能もビルドします。最新リリースからhamir.mcpbをダウンロードして開いてください。これは同じサーバーに接続する小さなローカルブリッジです。新しいツールがアップデートなしで利用でき、言語とエラーレポートの設定も追加されます。

変数	用途
HAMIR_LANGUAGE	パック名とラベルに使う言語。例：uk
HAMIR_ERROR_REPORTS	エラーレポートを送信する場合はtrue。それ以外はオフ
HAMIR_MCP_URL	開発用に転送する別のサーバー

開発

npm install
npm run typecheck && npm test
npm run sync-manifest    # copy tools and languages from the server into manifest.json
npm run pack             # build hamir.mcpb

プライバシーポリシー

ポリシー全文はhamir.app/privacyをご覧ください。

• 収集する情報： 各ツール呼び出しの引数（検索クエリなど）と言語設定です。アカウント、名前、メールアドレス、Cookie、デバイス識別子は収集しません。会話が送信されることはありません。
• 利用と保存： 引数は呼び出しへの応答に使用し、保存しません。IP アドレスはレート制限のために使用し、5 分以内に期限切れになるカウンターに記録します。また、ユーザーエージェントとともに hamir のリクエストログに記録します。
• 共有： 共有はありません。匿名のエラーレポート（拡張機能の設定にある「エラーレポートを送信」、または HAMIR_ERROR_REPORTS=true）を任意で有効にできます。レポートは、IP アドレス、Cookie、検索内容を含めずに、hamir のセルフホスト型トラッカーに送信されます。
• 保持期間： 引数は保持しません。リクエストログ（IP アドレス、ユーザーエージェント、パス。引数は含みません）は 30 日後に削除され、エラーレポートは 90 日後に削除されます。
• お問い合わせ： [email protected]

ライセンス

コードはMITです。hamir の名称とロゴ（icon.png）は対象外です。これらは hamir アプリを識別するものであり、フォークでは独自のものを使用する必要があります。