MCP Server Installation

Install and configure the Anysite MCP Server

Overview

The Anysite MCP (Model Context Protocol) Server provides AI tools with direct access to LinkedIn, Instagram, Reddit, and other social media data extraction capabilities.

Prerequisites

Python 3.8 or higher
Anysite API account and credentials
Compatible AI client (Claude Desktop, Cursor, Windsurf)

Installation

Clone Repository

```bash
git clone https://github.com/horizondatawave/hdw-mcp-server.git
cd hdw-mcp-server
```

Get API Credentials

1. Visit [anysite.io](https://app.anysite.io/register)
2. Create your account and log in
3. Navigate to account settings
4. Generate your API credentials:
   - `HDW_ACCESS_TOKEN`: Your API access token
   - `HDW_ACCOUNT_ID`: Your account identifier (optional)

Configure Environment

Create a `.env` file or set environment variables:
```bash
export HDW_ACCESS_TOKEN="your_access_token_here"
export HDW_ACCOUNT_ID="your_account_id_here"
```

Client Configuration

Claude Desktop

Add this configuration to your Claude Desktop config file:

macOS

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}
```

Windows

Edit `%APPDATA%\Claude\claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["C:\\path\\to\\hdw-mcp-server\\main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}
```

Cursor

Add to your Cursor settings:

{
  "mcp.servers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}

Windsurf

Configure in your Windsurf settings:

{
  "mcpServers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}

Verification

After installation, restart your AI client and verify the MCP server is working:

Open a new conversation in your AI client
Ask: "What MCP tools do you have available?"
You should see Anysite tools listed

Make sure to replace /path/to/hdw-mcp-server/ with the actual path where you cloned the repository.

Troubleshooting

MCP server not appearing in AI client

- Check that the file path in your configuration is correct
- Verify that Python is accessible from the command line
- Ensure your credentials are properly set in the environment variables
- Restart your AI client after making configuration changes

Authentication errors

- Verify your `HDW_ACCESS_TOKEN` and `HDW_ACCOUNT_ID` are correct
- Check that your Anysite account is active
- Ensure you have API access permissions

Python path issues

- Use the full path to your Python executable
- If using a virtual environment, use the Python path from that environment
- On Windows, use forward slashes or double backslashes in paths