Needle MCP Server

公式

本番環境対応のRAGをすぐに利用でき、自身のドキュメントからデータを検索・取得できます。

GitHub

ドキュメント

Needle MCP サーバーでエージェントを構築する

Screenshot of Feature - Claude

Claude のデスクトップアプリケーションを通じて Needle を使用し、ドキュメントを管理したり検索を実行したりするための MCP (Model Context Protocol) サーバーです。

概要

Needle MCP サーバーでは以下のことが可能です。

ドキュメントを整理・保存し、素早く取り出す。
Claude の大規模言語モデルを通じて強力な検索を実行する。
Needle エコシステムとシームレスに統合し、高度なドキュメント管理を実現する。

MCP (Model Context Protocol) は、LLM が外部データソースに接続する方法を標準化します。Needle MCP サーバーを使用すると、AI アプリケーションにセマンティック検索ツールを簡単に組み込むことができ、PDF、DOCX、XLSX などのファイルに埋もれたデータに LLM が即座にアクセスできるようになります。

最高のエクスペリエンスのために、リモート MCP サーバーの使用を推奨します。ローカルでのセットアップは不要です。

機能

ドキュメント管理: サーバー上でドキュメントを簡単に追加・整理できます。
検索と取得: Claude ベースの自然言語検索で素早く回答を得られます。
容易な統合: Claude Desktop や Needle コレクションと連携します。

使い方

Claude Desktop でのコマンド

以下は、Claude Desktop でサーバーとやり取りするためにコマンドをどのように使用できるかの例です。

Using commands in Claude Desktop

Claude Desktop を開き、Needle MCP サーバーに接続します。
シンプルなテキストコマンドを使用して、ドキュメントの検索、取得、変更を行います。
Claude から返された検索結果を、ユーザーフレンドリーなインターフェースで確認します。

Needle での結果

https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c

YouTube 動画による解説

Needle MCP サーバーを Claude および Claude Desktop で使用する完全なチュートリアルについては、こちらの YouTube 解説動画をご覧ください。

インストール

1. リモート MCP サーバー (推奨)

Claude Desktop の設定

設定ファイルを作成または更新します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:Bearer ${NEEDLE_API_KEY}"
      ],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Cursor の設定

.cursor/mcp.json を作成または更新します。

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:${NEEDLE_AUTH_HEADER}"
      ],
      "env": {
        "NEEDLE_AUTH_HEADER": "Bearer <your-needle-api-key>"
      }
    }
  }
}

API キーは Needle 設定から取得してください。

2 つのエンドポイントを提供しています。

Streamable HTTP: https://mcp.needle.app/mcp (推奨)
SSE: https://mcp.needle.app/sse

注意: 最新の仕様で MCP は SSE エンドポイントを非推奨としたため、新しいクライアントでは Streamable HTTP エンドポイントを優先してください。

2. ローカルインストール

リポジトリをクローンします。

git clone https://github.com/needle-ai/needle-mcp.git

Homebrew を使用して UV をグローバルにインストールします。

brew install uv

設定ファイルを作成します。
- MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows の場合: %APPDATA%/Claude/claude_desktop_config.json