mcpField
S
social-search-mcp

social-search-mcp

Local
github.com/shubhamekapureSearch0Updated 32w ago
Repository

About social-search-mcp

social-search-mcp is an MCP server for LLMs that searches selected social media domains using configurable search providers. It returns domain-filtered results through a single search_social tool.

Key features

  1. 01Search selected social platforms
  2. 02Filter results to platform domains
  3. 03Configure SearXNG, Serper.dev, or Google
  4. 04Return results through one search tool

Use cases

  1. 01Find Reddit discussions about a topic
  2. 02Search selected social sites for public posts

MCP support

The MCP server exposes a search_social tool that accepts a query and optional platform list, then returns results limited to the selected domains.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "shubhamekapure-social-search": {
      "command": "uvx",
      "args": [
        "social-search-mcp"
      ],
      "env": {
        "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
        "SERPER_API_KEY": "<SERPER_API_KEY>",
        "SEARXNG_URL": "<SEARXNG_URL>"
      }
    }
  }
}
Run commanduvx social-search-mcp
Environment variables to set
SEARCH_PROVIDERSearch backend: 'serper', 'searxng', or 'google'. Default: searxng
SERPER_API_KEYSecretAPI key from serper.dev. Required if SEARCH_PROVIDER=serper.
SEARXNG_URLURL of your SearXNG instance. Default: http://localhost:8080

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypisocial-search-mcp0.1.3

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Social Search MCP Server

A Model Context Protocol (MCP) server that empowers LLMs to search across specific social media platforms using the industry's best search engines.

Overview

This server provides a search_social tool that accepts a query and an optional list of platforms (facebook, reddit, linkedin, etc.). It filters results exclusively to those domains and returns them directly to the LLM context.

Search Providers

You can configure the backend by setting the SEARCH_PROVIDER environment variable. By default, it uses SearXNG since it is free and open-source.

1. SearXNG (Default)

SearXNG is a free, open-source internet metasearch engine.

  • SEARCH_PROVIDER=searxng
  • SEARXNG_URL=http://localhost:8080 (Defaults to localhost, specify a remote public instance if you don't host your own, but note that public instances often limit automated JSON requests).
2. Serper.dev

A powerful Google Search wrapper API. Highly recommended for accurate results.

  • SEARCH_PROVIDER=serper
  • SERPER_API_KEY=your_key (Get one from Serper.dev)
3. Google Custom Search

The official Google Custom Search API.

  • SEARCH_PROVIDER=google
  • GOOGLE_API_KEY=your_key
  • GOOGLE_CX=your_cx_engine_id

Setup

Ensure you have Python 3.10+ installed.

# Clone or place in a directory, then:
python -m venv venv
source venv/bin/activate
pip install -e .

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "social-search-mcp": {
      "command": "/ABSOLUTE/PATH/TO/venv/bin/social-search-mcp",
      "args": [],
      "env": {
        "SEARCH_PROVIDER": "searxng",
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Replace /ABSOLUTE/PATH/TO/ with the actual path to this folder. Restart Claude Desktop after updating the config.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.