Skip to main content

MCP server for integrating Macrocosmos SN13 social media data into Claude Desktop and Cursor

Project description

🌌 Macrocosmos MCP

Macrocosmos MCP lets you integrate SN13 and SN1 APIs directly into Claude for Desktop or Cursor. Instantly tap into social data, perform live web searches, and explore Hugging Face models — all from within your AI environment.


⚡ Features

  • 🔍 Query X (Twitter) and Reddit data on demand
  • 📚 Explore SN13 Hugging Face repositories and datasets

🚀 Quick Setup

1. Clone the Repo

git clone https://github.com/macrocosm-os/macrocosmos-mcp.git
cd macrocosmos-mcp/src

2. Install Requirements (requires uv)

uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx macrocosmos

3. Configure Claude or Cursor

Open the MCP config file:

  • Claude: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Cursor: ~/Library/Application Support/Cursor/cursor_mcp_config.json

Add this entry:

"macrocosmos": {
    "command": "uv",
    "args": [
        "--directory",
        "/full_path_to_repo/macrocosmos_mcp/src/",
        "run",
        "macrocosmos_mcp.py"
    ],
    "env": {
        "MC_API": "",
    }
}

Replace /full_path_to_repo/ with your full local path and insert your API keys.


🔮 Upcoming

  • 🧠 All the power of Subnets in your AI environment — coming soon.

MIT License Made with ❤️ by the Macrocosm OS team

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

macrocosmos_mcp-0.1.0.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

macrocosmos_mcp-0.1.0-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file macrocosmos_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: macrocosmos_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.22

File hashes

Hashes for macrocosmos_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e81dfbcb91b5371b193eb764b0edf7846238703468ee022702f011f673060707
MD5 59e41747bbe9a8a5e443b6c0037b6a85
BLAKE2b-256 e77b15fe6d8801280c49f8a0fb088b11615216beb15920dc558f6d15d19baa18

See more details on using hashes here.

File details

Details for the file macrocosmos_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for macrocosmos_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ff015c1f6ef3189d6691968da65f3a19b4e2579994e05caedd18d7b1f523753b
MD5 01834df78a61f02d2ab499fb64f3e4c3
BLAKE2b-256 659b34ba2d0b0184938094195821a8310fc889c19e513d0488e7067b68835fa9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page