Skip to main content
Glama
Needle MCP Server

Needle MCP Server

Official
by needle-ai

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

鍛冶屋のバッジ

特集のスクリーンショット - クロード

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

目次


Related MCP server: Documentation MCP Server

概要

Needle MCP サーバーを使用すると、次のことが可能になります。

  • すぐに取り出せるようにドキュメントを整理して保存します。

  • Claude の大規模言語モデルを使用して強力な検索を実行します。

  • 高度なドキュメント管理のために Needle エコシステムとシームレスに統合します。


特徴

  • **ドキュメント管理:**サーバー上のドキュメントを簡単に追加および整理できます。

  • **検索と取得:**クロード ベースの自然言語検索で迅速な回答が得られます。

  • 簡単な統合: Claude Desktopおよび Needle コレクションと連携します。


使用法

Claude Desktopのコマンド

以下は、Claude Desktop でコマンドを使用してサーバーと対話する方法の例です。

Claude Desktop のコマンドの使用

  1. Claude Desktop を開き、Needle MCP サーバーに接続します。

  2. **簡単なテキスト コマンドを使用して、**ドキュメントを検索、取得、または変更します。

  3. Claude によって返された検索結果をユーザーフレンドリーなインターフェースで確認します。

針の結果

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


Youtubeビデオの説明

Needle MCP Server を Claude および Claude Desktop と共に使用する詳細な手順については、このYouTube 説明ビデオをご覧ください。


インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Needle MCP を自動的にインストールするには:

npx -y @smithery/cli install needle-mcp --client claude

手動インストール

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

git clone https://github.com/yourusername/needle-mcp.git
  1. ターミナルで Homebrew を使用して UV をグローバルにインストールします。

brew install uv
  1. claude_desktop_config.json を作成します。

    • MacOSの場合: ~/Library/Application Support/Claude/ディレクトリを開き、その中にファイルを作成します。

    • Windowsの場合: %APPDATA%/Claude/ディレクトリを開き、その中にファイルを作成します。

  2. この構成を claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
  1. needle.xyzからNeedle APIキーを取得します

  2. 設定ファイルを更新します。

    • /path/to/needle-mcp実際のリポジトリパスに置き換えます。

    • Needle APIキーを追加する

  3. クロードを完全に終了して再度開く

使用例

  • 「「技術文書」という新しいコレクションを作成します」

  • 「このドキュメントをコレクション(https://needle-ai.com )に追加します」

  • 「AIに関する情報をコレクションから検索」

  • 「すべてのコレクションを一覧表示する」

トラブルシューティング

動作しない場合:

  • UV がグローバルにインストールされていることを確認します (インストールされていない場合は、 pip uninstall uvでアンインストールし、 brew install uvで再インストールします)

  • またはUVパスを見つけてwhich uv``"command": "uv"フルパスに置き換えます

  • Needle APIキーが正しいことを確認してください

  • config内のneedle-mcpパスが実際のリポジトリの場所と一致しているかどうかを確認します。

Claude デスクトップ設定をリセット

古い設定が表示される場合、または統合が機能しない場合は、次の手順に従ってください。

  1. Claude Desktop のすべての構成ファイルを検索します。

find / -name "claude_desktop_config.json" 2>/dev/null
  1. Claude Desktop のすべてのデータを削除します。

  • MacOSの場合: rm -rf ~/Library/Application\ Support/Claude/*

  • Windowsの場合: %APPDATA%/Claude/の内容を削除します。

  1. Needle のみを使用して新しい構成を作成します。

mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
<< 'EOL'
{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL
  1. Claude Desktopを完全に終了し(Macの場合はCommand+Q)、再起動します。

  2. まだ古い設定が表示される場合:

  • 他の場所にある追加の設定ファイルを確認する

  • ウェブ版をご利用の場合はブラウザのキャッシュをクリアしてみてください

  • 設定ファイルが正しい場所から読み込まれていることを確認します

Available Tools

7 tools
needle_add_fileAInspect

Add a new document to a Needle collection by providing a URL for download. Supports multiple file formats including: - PDF documents - Microsoft Word files (DOC, DOCX) - Plain text files (TXT) - Web pages (HTML)

        The document will be:
        1. Downloaded from the provided URL
        2. Processed for text extraction
        3. Indexed for semantic search
        
        Use this tool when you need to:
        - Add new documents to a collection
        - Make documents searchable
        - Expand your knowledge base
        
        Important: Documents require processing time before they're searchable.
        Check processing status using needle_list_files before searching new content.

Inputs: collection_id (required), name (required), url (required).

needle_create_collectionAInspect

Create a new document collection in Needle for organizing and searching documents. A collection acts as a container for related documents and enables semantic search across its contents. Use this tool when you need to: - Start a new document organization - Group related documents together - Set up a searchable document repository Returns a collection ID that's required for subsequent operations. Choose a descriptive name that reflects the collection's purpose for better organization.

Inputs: name (required).

needle_get_collection_detailsAInspect

Fetch comprehensive metadata about a specific Needle collection. Provides detailed information about the collection's configuration, creation date, and current status. Use this tool when you need to: - Verify a collection's existence and configuration - Check collection metadata before operations - Get creation date and other attributes Requires a valid collection ID and returns detailed collection metadata. Will error if collection doesn't exist.

Inputs: collection_id (required).

needle_get_collection_statsAInspect

Retrieve detailed statistical information about a Needle collection's contents and status. Provides metrics including: - Total number of documents - Processing status of documents - Storage usage and limits - Index status and health Use this tool to: - Monitor collection size and growth - Verify processing completion - Check collection health before operations Essential for ensuring collection readiness before performing searches.

Inputs: collection_id (required).

needle_list_collectionsAInspect

List Needle collections. Returns maximum of 20 results. Get more results by increasing the offset. Returns detailed information including collection IDs, names, and creation dates. Use this tool when you need to: - Get an overview of available document collections - Find collection IDs for subsequent operations - Verify collection existence before performing operations The response includes metadata that's required for other Needle operations.

Inputs: offset.

needle_list_filesAInspect

List all documents stored within a specific Needle collection with their current status. Returns detailed information about each file including: - File ID and name - Processing status (pending, processing, complete, error) - Upload date and metadata Use this tool when you need to: - Inventory available documents - Check processing status of uploads - Get file IDs for reference - Verify document availability before searching Essential for monitoring document processing completion before performing searches.

Inputs: collection_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: collection management (create, list, get details, get stats), file management (add, list), and search. The descriptions explicitly differentiate their functions, such as needle_get_collection_details for metadata vs. needle_get_collection_stats for metrics, eliminating any ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with the 'needle_' prefix, using snake_case throughout (e.g., needle_create_collection, needle_list_files). This predictable naming scheme makes it easy for agents to understand and select tools based on their actions and targets.

    Tool Count5/5

    With 7 tools, the server is well-scoped for document management and search, covering essential operations like collection CRUD, file addition, status monitoring, and semantic search. Each tool serves a clear purpose without redundancy, fitting the domain's needs efficiently.

    Completeness4/5

    The toolset provides strong coverage for core document management workflows, including collection lifecycle, file processing, and search. A minor gap exists in file deletion or update capabilities, which could limit full CRUD operations, but agents can still perform key tasks like adding, listing, and searching documents effectively.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers