JANHMS Needle MCP Server

🚀 Claude用Needle MCPサーバー

管理ドキュメントを扱い、Claudeチャットを通じて意味検索を行うMCP（管理制御平面）サーバーです。

🚀 クイックスタート

🔍 示例

Claudie Desktopで使用するコマンドの例

Claudeを通じてNeedleでこのコレクションを設定する方法

リソースへのリンク

📦 インストール

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

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

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

   brew install uv
   

3. claude_desktop_config.jsonファイルを作成します：

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

4. 以下の設定を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"
         }
       }
     }
   }
   

5. NeedleからAPIキーを取得します。

6. 設定ファイルを更新します：

   • /path/to/needle-mcpを実際のリポジトリのパスに置き換えます。
   • Needle APIキーを追加します。

7. Claudeを完全に終了し、再度開きます。

💻 使用例

• "名前が'Technical Docs'の新しいコレクションを作成する"
• "このドキュメントをコレクションに追加する、リンクはhttps://needle-ai.com"
• "コレクション内でAIに関する情報を検索する"
• "私のすべてのコレクションを一覧表示する"

🔧 トラブルシューティング

正常に動作しない場合：

• UVがグローバルにインストールされていることを確認します（インストールされていない場合は、pip uninstall uvでアンインストールし、brew install uvで再インストールします）。
• または、UVのパスを見つけて、設定内の"command": "uv"を完全なパスに置き換えます。例：$ which uv。
• Needle APIキーが正しいことを検証します。
• 設定ファイル内のneedle-mcpのパスが実際のリポジトリの場所と一致していることを確認します。

Claude Desktop設定のリセット

古い設定が表示されるか、統合が機能しない場合：

1. すべてのClaude Desktop設定ファイルを検索します：

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

2. すべてのClaude Desktopデータを削除します：

   • 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