JANHMS_needle-mcp-server

The Needle MCP server is a robust solution for managing documents and executing semantic searches via Claude chat. It leverages the Needle platform to create, manage, and search document collections efficiently. The server is set up by cloning the repository and configuring it with the Needle API key. It integrates seamlessly with Claude Desktop, allowing users to perform operations like creating collections, adding documents, and searching for information within collections. The setup process involves installing necessary tools like UV and configuring the Claude Desktop with the appropriate settings. Troubleshooting steps are provided to ensure smooth operation, including verifying installations and configurations.

Features

• Document Management: Easily manage and organize documents into collections.
• Semantic Search: Perform advanced searches within document collections using semantic understanding.
• Integration with Claude: Seamless integration with Claude Desktop for enhanced user experience.
• Customizable Configuration: Flexible setup with customizable configuration files.
• Troubleshooting Support: Comprehensive troubleshooting steps to resolve common issues.

Usage with Different Platforms

macOS

bash
git clone https://github.com/yourusername/needle-mcp.git
brew install uv
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

windows

bash
git clone https://github.com/yourusername/needle-mcp.git
# Install UV using a suitable package manager or manually
# Create claude_desktop_config.json in %APPDATA%/Claude/
{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}