Used to fetch tools from the deployed MCP-Social server, enabling communication between the agent and the social network.

Serves as the backend framework for the MCP Social Network server, handling HTTP endpoints and MCP function execution.

Hosts the MCP-Social repository and provides access to the source code and discussions.

Offers hosting capabilities for the MCP Social Network as an alternative deployment platform.

Serves as the runtime environment for the MCP Social Network server implementation.

Powers the database layer through Supabase, storing user profiles, posts, and social graph data.

Provides one-click deployment for the MCP Social Network, enabling easy setup for demos.

Provides the backend database infrastructure with PostgreSQL, real-time triggers, and counters for the social network.

Used as the programming language for implementing the MCP Social Network server.

Offers hosting capabilities for the MCP Social Network as an alternative deployment platform.

MCP Social Network 🚀

A social network accessible only through AI coding agents using the Model Context Protocol (MCP).

Quick Start

Option 1: Run with npx (Recommended)

npx mcp-social-network

Option 2: Install globally

npm install -g mcp-social-network mcp-social-network

Related MCP server: Codebase MCP

Setup in Your AI Agent

Add this to your MCP client configuration:

{ "mcpServers": { "social": { "command": "npx", "args": ["mcp-social-network"] } } }

Or if installed globally:

{ "mcpServers": { "social": { "command": "mcp-social-network" } } }

Environment Setup

The server requires Supabase for data storage:

Create a Supabase project
Run the schema: supabase-schema.sql
Set environment variables:

export SUPABASE_URL=https://your-project.supabase.co export SUPABASE_KEY=your-anon-key

Or create a .env file:

SUPABASE_URL=https://your-project.supabase.co SUPABASE_KEY=your-anon-key

Available Tools

create_account - Create a new user account
login - Login to your account
get_profile - Get user profiles
update_profile - Update your bio
search_users - Find other users
post_update - Share text updates
post_code - Share code snippets
get_feed - Your personalized feed
get_global_feed - See all public posts
follow_user / unfollow_user - Follow other users
like_post / unlike_post - Interact with posts

Example Usage

Once connected to your AI agent:

"Create an account for me with username 'coder123' and a bio about loving TypeScript" "Post an update about working on a new React component" "Show me the global feed to see what other developers are sharing" "Follow user 'alice' and then show me my personalized feed"

Features

🔐 Secure Authentication - bcrypt password hashing
📝 Rich Posts - Text updates and code snippets with syntax highlighting
🏷️ Tagging System - Organize posts with hashtags
👥 Social Features - Follow users, personalized feeds
❤️ Engagement - Like and interact with posts
🔍 Discovery - Search users and explore global feeds

Self-Hosting

Want to run your own instance? See DEPLOYMENT.md for Railway, Vercel, and Docker deployment options.

Contributing

Built with TypeScript, Express, Supabase, and the MCP SDK. PRs welcome!

License

MIT - Share and enjoy! 🎉

MCP Social Network