MCP Dev Network

A social network for developers, built as an MCP server. Connect your AI-powered IDE and interact with other devs — send messages, share resources, post to a public feed, follow people, and discover developers by stack.

Una red social para desarrolladores, construida como servidor MCP. Conecta tu IDE con IA e interactúa con otros devs — envía mensajes, comparte recursos, publica en un feed público, sigue personas y descubre gente por tecnología.

---

🚀 Quick Start / Inicio Rápido

1. Sign up / Registrarse

curl -X POST https://mcp-dev-network-production.up.railway.app/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@email.com","password":"yourpassword"}'

You'll get back a token and user_id. Save the token.

Recibirás un token y user_id. Guarda el token.

2. Connect your IDE / Conectar tu IDE

Kiro

Edit .kiro/settings/mcp.json:

{
  "mcpServers": {
    "dev-network": {
      "url": "https://mcp-dev-network-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Cursor

Edit .cursor/mcp.json:

{
  "mcpServers": {
    "dev-network": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp-dev-network-production.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

Antigravity (Google)

Edit ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "dev-network": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp-dev-network-production.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "dev-network": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp-dev-network-production.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

3. Register your profile / Registrar tu perfil

Once connected, ask your AI assistant:

"Register my profile with username yourname and stack [python, typescript, react]"

Una vez conectado, pide a tu asistente IA:

"Registra mi perfil con username tunombre y stack [python, typescript, react]"

---

🛠️ Available Tools / Herramientas Disponibles (20)

Profiles / Perfiles

Tool	Description / Descripción	Arguments
register	Create your profile / Crear tu perfil	username, stack[], bio
get_profile	View a user's profile / Ver perfil de un usuario	username
get_my_profile	View your own profile / Ver tu propio perfil	—
list_users	Browse all devs / Ver todos los devs	limit?, offset?
search_users	Find devs by stack or name / Buscar devs por stack o nombre	query?, stack?[]

Social / Red Social

Tool	Description / Descripción	Arguments
follow	Follow a developer / Seguir a un dev	username
unfollow	Unfollow a developer / Dejar de seguir	username
my_following	List who you follow / Ver a quién sigues	—
discover	Discover devs to follow / Descubrir devs	stack?[]

Feed

Tool	Description / Descripción	Arguments
create_post	Publish to public feed / Publicar en el feed	content, tags?[]
get_feed	Read recent posts / Leer posts recientes	limit?, before_id?, tag?
delete_post	Delete your own post / Borrar tu post	post_id
like_post	Like a post / Dar like a un post	post_id

Messaging / Mensajería

Tool	Description / Descripción	Arguments
send_message	Send encrypted private message / Enviar mensaje cifrado	to_username, content
get_messages	Read your inbox / Leer tu bandeja	limit?, before_id?

Notifications / Notificaciones

Tool	Description / Descripción	Arguments
get_notifications	View your alerts / Ver tus alertas	limit?
mark_read	Mark notifications as read / Marcar como leídas	notification_ids[]

Resources / Recursos

Tool	Description / Descripción	Arguments
share_resource	Share a link or snippet / Compartir link o snippet	title, url_or_snippet, tags[]
search_resources	Search by tags or full-text / Buscar por tags o texto	tags?[], query?

Moderation / Moderación

Tool	Description / Descripción	Arguments
report_content	Report inappropriate content / Reportar contenido	content_id, reason

---

💬 Usage Examples / Ejemplos de Uso

Once connected, just talk to your AI assistant naturally:

Una vez conectado, habla con tu asistente IA de forma natural:

What you say / Lo que dices	Tool used
"Find developers who know Rust"	search_users
"Follow user maria_dev"	follow
"Who am I following?"	my_following
"Discover people who work with Python"	discover
"Send a message to luis saying hi"	send_message
"Check my messages"	get_messages
"Post: just deployed my first MCP server!"	create_post
"Like post #5"	like_post
"Show me the latest posts"	get_feed
"Check my notifications"	get_notifications
"Share this tutorial about FastAPI"	share_resource
"Search resources about typescript"	search_resources

---

🔒 Security / Seguridad

• AES-256-GCM encryption for all private messages / Cifrado para mensajes privados
• JWT RS256 authentication (OAuth 2.1 compatible)
• Row-Level Security in PostgreSQL — each user can only access their own data / Cada usuario solo accede a sus datos
• Rate limiting — 20 messages/hour, 20 posts/hour, 10 resources/hour
• Untrusted Content Wrapper — protects against prompt injection / Protege contra inyección de prompts

---

📡 API Details / Detalles de la API

Base URL: https://mcp-dev-network-production.up.railway.app

Endpoint	Method	Auth	Description
/	GET	No	Landing page
/health	GET	No	Health check
/auth/signup	POST	No	Create account, get token
/auth/login	POST	No	Login, get fresh token
/mcp	POST	Bearer JWT	MCP tool invocations (JSON-RPC 2.0)
/admin?secret=X	GET	Secret	Admin dashboard

MCP Request Format / Formato de petición MCP

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": { ... }
  },
  "id": 1
}

---

🏗️ Tech Stack

Layer	Technology
Runtime	Python 3.11 + FastAPI + uvicorn
Database	PostgreSQL (Supabase) with RLS
Encryption	AES-256-GCM (cryptography)
Auth	JWT RS256 (python-jose)
Deploy	Railway
Protocol	MCP over HTTP Streamable (JSON-RPC 2.0)

---

🤝 Contributing / Contribuir

This is an open project. If you want to contribute:

1. Fork the repo
2. Create a feature branch
3. Submit a PR

Ideas for contributions:

• Thread replies to posts / Respuestas en hilo
• Reactions beyond likes / Reacciones más allá de likes
• Web frontend dashboard
• Group chats / Chats grupales
• Profile badges / Insignias de perfil

---

📄 License / Licencia

MIT