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

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

概要

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

すぐに取り出せるようにドキュメントを整理して保存します。
Claude の大規模言語モデルを使用して強力な検索を実行します。
高度なドキュメント管理のために Needle エコシステムとシームレスに統合します。

特徴

**ドキュメント管理:**サーバー上のドキュメントを簡単に追加および整理できます。
**検索と取得:**クロードベースの自然言語検索で迅速な回答が得られます。
簡単な統合: Claude Desktopおよび Needle コレクションと連携します。

使用法

Claude Desktopのコマンド

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

Claude Desktop を開き、Needle MCP サーバーに接続します。
**簡単なテキストコマンドを使用して、**ドキュメントを検索、取得、または変更します。
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

手動インストール

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

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

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

brew install uv

claude_desktop_config.json を作成します。
- MacOSの場合: ~/Library/Application Support/Claude/ディレクトリを開き、その中にファイルを作成します。
- Windowsの場合: %APPDATA%/Claude/ディレクトリを開き、その中にファイルを作成します。
この構成を 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"
      }
    }
  }
}

needle.xyzからNeedle APIキーを取得します
設定ファイルを更新します。
- /path/to/needle-mcp実際のリポジトリパスに置き換えます。
- Needle APIキーを追加する
クロードを完全に終了して再度開く

使用例

「「技術文書」という新しいコレクションを作成します」
「このドキュメントをコレクション（https://needle-ai.com ）に追加します」
「AIに関する情報をコレクションから検索」
「すべてのコレクションを一覧表示する」

トラブルシューティング

動作しない場合:

UV がグローバルにインストールされていることを確認します (インストールされていない場合は、 pip uninstall uvでアンインストールし、 brew install uvで再インストールします)
またはUVパスを見つけてwhich uv``"command": "uv"フルパスに置き換えます
Needle APIキーが正しいことを確認してください
config内のneedle-mcpパスが実際のリポジトリの場所と一致しているかどうかを確認します。

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

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

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

find / -name "claude_desktop_config.json" 2>/dev/null

Claude Desktop のすべてのデータを削除します。

MacOSの場合: rm -rf ~/Library/Application\ Support/Claude/*
Windowsの場合: %APPDATA%/Claude/の内容を削除します。

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

Claude Desktopを完全に終了し（Macの場合はCommand+Q）、再起動します。
まだ古い設定が表示される場合:

他の場所にある追加の設定ファイルを確認する
ウェブ版をご利用の場合はブラウザのキャッシュをクリアしてみてください
設定ファイルが正しい場所から読み込まれていることを確認します

Needle MCP Server