Needle MCP Server

🚀 針を使ったMCPサーバーのプロキシ構築

Needle を使用して、Claudeのデスクトップアプリケーションでドキュメントを管理し、検索を実行するMCP（モデルコンテキストプロトコル）サーバーです。

🚀 クイックスタート

このNeedle MCPサーバーを使うことで、ドキュメントの管理や強力な検索が可能になります。以下では、サーバーの概要、機能、使用方法、インストール手順などを説明します。

✨ 主な機能

• ドキュメント管理：サーバー上でドキュメントを簡単に追加し、整理することができます。
• 検索と取得：Claudeの自然言語ベースの検索を通じて、迅速に答えを見つけることができます。
• 簡単な統合：Claudeデスクトップ とNeedleコレクションと一緒に使用できます。

📦 インストール

Smitheryを通じたインストール

Smithery を通じて、Claudeデスクトップ用のNeedle MCPを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install needle-mcp --server-id=your-server-id

手動インストール

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

git clone https://github.com/your-username/needle-mcp.git
cd needle-mcp
npm install

💻 使用例

基本的な使用法

Claudeデスクトップでのコマンド

Claudeデスクトップで以下のコマンドを使用してサーバーとやり取りする例を示します。

1. Claudeデスクトップ を開き、Needle MCPサーバーに接続します。
2. 簡単なテキストコマンドを使用して、ドキュメントを検索、取得、または変更します。
3. ユーザーフレンドリーなインターフェイスで、Claudeが返す検索結果を表示します。

Needleでの結果

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

高度な使用法

YouTube動画での解説

ClaudeとClaudeデスクトップでNeedle MCPサーバーを使用する詳細なチュートリアルは、この YouTube解説動画 をご覧ください。

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

古い設定が表示されたり、統合が機能しない場合は、以下の手順で設定をリセットします。

1. すべてのClaudeデスクトップ設定ファイルを見つけます。

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

2. すべてのClaudeデスクトップデータを削除します。

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

3. 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

4. Claudeデスクトップを完全に終了し（Macの場合はCommand+Q）、再起動します。
5. 古い設定がまだ表示される場合は、以下のことを試してみてください。

• 他の場所に追加の設定ファイルがないか確認します。
• ネットワークバージョンを使用している場合は、ブラウザのキャッシュをクリアしてみます。
• 設定ファイルが正しい場所から読み込まれていることを確認します。