Perigon MCP Server

🚀 Perigon MCP Server

これは、PerigonニュースAPIの公式MCPサーバーです。Perigon MCPサーバーを使用することで、ニュースデータの取得や検索を効率的に行うことができます。

🚀 クイックスタート

Perigon MCPサーバーの詳細な使い方や接続方法については、MCPのドキュメントを参照してください。

✨ 主な機能

Perigon MCPサーバーは、以下のような機能を提供しています。

• ニュース記事やストーリーの検索
• ジャーナリストや情報源の検索
• 人物や企業に関するニュースの検索

📚 ドキュメント

プレイグラウンド

プレイグラウンドでPerigon MCPサーバーを試すことができます。

⚠️ 重要提示

MCPを使用するには有効なPerigon APIキーが必要です。MCPプレイグラウンドを使用するには、Perigonダッシュボードに認証済みである必要があります。

接続方法

ローカルまたはリモートのMCPクライアントを使用して、リモートのMCPサーバーに接続することができます。

サーバーURL: https://mcp.perigon.io

サポートされる接続タイプ:

• HTTP (ストリーム可能): https://mcp.perigon.io/v1/mcp
• Server-Sent Events (SSE): https://mcp.perigon.io/v1/sse

クイックセットアップの例

MCPクライアント（mcp-remoteを使用したSSE）:

{
  "mcpServers": {
    "perigon_news_api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.perigon.io/v1/sse",
        "--header",
        "Authorization: Bearer ${PERIGON_API_KEY}"
      ],
      "env": {
        "PERIGON_API_KEY": "YOUR_PERIGON_API_KEY"
      }
    }
  }
}

MCPクライアント（SSEサポート付き）:

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/sse",
      "type": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

HTTP（ストリーム可能）をサポートするクライアント:

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Claude Code (CLI):

claude mcp add --transport sse perigon_news_api https://mcp.perigon.io/v1/sse \
  --header "Authorization: Bearer YOUR_PERIGON_API_KEY"

📖 異なるクライアントの詳細なセットアップ手順については、包括的なMCPドキュメントを参照してください。

Smitheryへのデプロイ

このMCPサーバーは、含まれているDocker構成を使用してSmitheryに簡単にデプロイできます。リポジトリには以下が含まれています。

• Dockerfile - コンテナビルド構成
• smithery.yaml - Smitheryデプロイ構成
• server.js - MCPのHTTPサーバーラッパー

構成オプション:

• apiKey (必須): あなたのPerigon APIキー
• rateLimitBypass (オプション): コンテナ化された環境でのレート制限をバイパスします（デフォルト: true）

MCPエンドポイントは/mcpで利用可能になり、Smitheryのクエリパラメータ構成形式を自動的に処理します。

プロンプトの例

エージェントにプロンプトを与える際には、エージェントが既にそのような情報にアクセスできる場合を除き、現在の日付（またはそれを取得するツール）を提供することをお勧めします。これは、Claudeのような一部のモデルが、そうでない場合に現在の日付をそれらの知識の切れ目と考え、頻繁に古い情報を取得するためです。

ニュース記事とストーリー:

• 今日の米国のトップ5の政治ヘッドラインを教えて。
• 今日ニューヨークで流行っているビジネスの話題は何ですか？
• 今週のカリフォルニアの最新のテクノロジーニュースを見せて。
• 過去3日間のスイング州の政治ニュースを見つけて。
• 過去1週間の暗号通貨関連の記事を見せて。

ジャーナリストと情報源:

• テキサスの地元ニュース情報源を見つけて。
• 主要な出版物のトップビジネスジャーナリストは誰ですか？
• 再生可能エネルギーを扱っているジャーナリストを見つけて、彼らの最近の記事を見せて。
• 気候政策について最も多く書いているジャーナリストは誰ですか？
• 今日の主要な金融出版物の記事を見せて。

人物と企業:

• 製薬会社のCEOに関する最近のニュースを見つけて。
• 企業としてTeslaを検索し、彼らに関する最近のニュース記事を見つけて。
• 電気自動車産業の企業を見せて。
• 医療関連の記事で言及されている政治家を検索して。
• テクノロジー企業はAI規制について何を言っていますか？

💻 使用例

基本的な使用法

以下は、MCPクライアント（mcp-remoteを使用したSSE）の設定例です。

{
  "mcpServers": {
    "perigon_news_api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.perigon.io/v1/sse",
        "--header",
        "Authorization: Bearer ${PERIGON_API_KEY}"
      ],
      "env": {
        "PERIGON_API_KEY": "YOUR_PERIGON_API_KEY"
      }
    }
  }
}

高度な使用法

以下は、Claude Code (CLI) を使用してMCPサーバーに接続する例です。

claude mcp add --transport sse perigon_news_api https://mcp.perigon.io/v1/sse \
  --header "Authorization: Bearer YOUR_PERIGON_API_KEY"

📦 サポートされるツール

🔧 問題の報告と貢献

問題の報告

このMCPサーバーはまだ開発中です。ユーザーがこのサーバーで解決したいユースケースを決定しています。特別な要求や機能が必要な場合は、このリポジトリでGitHubのissueを開いてください。フィードバックを喜んで受け付けます。

貢献方法

このツールは意図的にオープンソースになっています。特定の機能が必要な場合は、issueを開くかPRを提出してください。Perigonの担当者がレビューします。

🔧 ローカル開発

パッケージ管理には bun を使用しています。

環境変数

以下の環境変数を .dev.vars に追加してください。

MCPプレイグラウンド（ツールインスペクターとチャット）に貢献したい場合は、ネットワークホストファイル（Macの場合は /etc/hosts）を変更して以下を含めるようにしてください。

127.0.0.1 local-mcp.perigon.io

これにより、ローカル開発中にperigon.ioのクッキーを利用できるようになります。

# 依存関係のインストール
bun i
# MCPサーバーとMCPプレイグラウンドを実行
bun dev