Naver OpenAPI

🚀 Naver MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）を使用して実装されたNaver OpenAPIサーバーです。Naverの様々なサービス（ブログ検索、ニュース検索、書籍検索など）とのインタラクションを可能にするツールを提供します。

🚀 クイックスタート

Naver MCPサーバーを使用するには、まずNaver OpenAPIへのアクセスを申請する必要があります。以下のリンクから登録申請を行えます。

https://developers.naver.com/apps/#/register=datalab

📦 インストール

PyPi経由（Claude Desktop）

Claude Desktopを使用してインストールするには、以下のコマンドを実行します。

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

Claude Desktop上で直接実行するには、以下のコマンドを使用します。

pip install mcp-naver

python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

PyPi経由（Cursor）

Cursor上でインストールするには、以下のコマンドを実行します。

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.cursor \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

ソースコードからのインストール

# リポジトリをクローン
git clone https://github.com/pfldy2850/py-mcp-naver.git

# 依存関係をインストールして実行
pip install -r requirements.txt
python main.py

✨ 主な機能

このサーバーは、Naverサービスとのインタラクションに役立つ様々なツールを提供します。主な機能は以下の通りです。

• ブログ検索：search_blog 関数を使用してNaverブログの内容を検索します。
• ニュース検索：search_news を使用して関連するニュース記事を検索します。
• ウェブ検索：search_webkr を利用して一般的なウェブページを検索します。
• 画像検索：search_image を使用して画像を検索し、フィルターを設定することもできます。
• ショッピング検索：search_shop を使用して商品情報を閲覧し、フィルタリング機能もサポートしています。

💻 使用例

基本的な使用法

1. リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/pfldy2850/py-mcp-naver.git
cd py-mcp-naver
pip install -r requirements.txt

2. 環境変数を設定するか、コード内でNaver APIのクライアントIDとシークレットを設定します。

以下は簡単な使用例です。

from mcp_server import NaverMCP

# サーバーインスタンスを初期化
naver = NaverMCP(client_id="your_client_id", client_secret="your_client_secret")

# ブログ内容を検索
blogs = naver.search_blog(query="Python開発")
print(blogs)

📚 ドキュメント

完全なAPIドキュメントについては、プロジェクトリポジトリの docs ディレクトリを参照するか、公式ウェブサイトを訪問してください。

📄 ライセンス

このプロジェクトはオープンソースソフトウェアであり、MITライセンス の下で提供されています。