convez.ai
MCP ServerIntegração & APIsIntermediário
The-Relational-Technology-Project

RT MCP Server

The-Relational-Technology-Project/rt-mcp-server

Acervo de tecnologia relacional e práticas comunitárias via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que oferece acesso a um acervo de 275+ itens sobre tecnologia relacional e práticas comunitárias — metodologia RTP, receitas de vizinhança, frameworks e referências de campo. Qualquer ferramenta compatível com MCP pode consultar este conhecimento coletivo em tempo real via endpoint hospedado.

Instalação

$npx convez-ai The-Relational-Technology-Project/rt-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 5 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar conhecimento sobre design comunitário em assistentes IA
  • Consultar receitas de vizinhança e estratégias comprovadas para organizadores comunitários
  • Acessar frameworks e metodologia RTP durante desenvolvimento de projetos relacionais

Veredito

MCP server bem estruturado que democratiza acesso a conhecimento comunitário consolidado, com foco em vizinhança e tecnologia relacional. Excelente para times que querem integrar perspectiva de design comunitário em ferramentas IA, ainda que o caso de uso seja nicho.

README

A tradução para o português deste README ainda está na fila.

RT MCP Server

Hosted MCP service for the Relational Tech Project — RTP methodology, neighborhood recipes, frameworks, and field references, accessible to any AI builder tool via URL.

"We are the river — carrying stories, tools, learning, and relationships across many local gardens, while honoring that each garden must be tended by those who live there."

Made in the Outer Sunset, for neighborhoods everywhere.


What This Does

The RT MCP Server is the hosted gateway to the RTP global commons — a shared library of neighborhood practice and relational tech knowledge that any MCP-compatible AI tool can query.

When you connect your AI tool to this server, you get access to 275+ canonical items (and growing as Studios across the network contribute back):

  • 8 RTP methodology docs — the foundational frameworks (core principles, three layers, builder spectrum, embedded design, measurement, playbooks, challenges, network)
  • 7 frameworks — cross-practice patterns like the 10 Principles of Neighboring, 5 Cs of Community, Asset-Based Community Development
  • 63 neighborhood recipes — actionable how-tos with ingredients, steps, variations, and stories (block parties, mutual aid pods, repair cafes, restorative circles, skillshares, and many more)
  • 197 field references — practitioners' work, organizations, books, and research (Block Party USA, Priya Parker, Dean Spade, ABCD Institute, microsolidarity, and dozens more)

As of v0.2.0 the server queries the commons live — no hardcoded knowledge — so the catalog grows automatically as items are added.

The hosted endpoint is at https://mcp.relationaltechproject.org/mcp. For a local stdio version, set RTP_MCP_TRANSPORT=stdio when running the same code.


For Builders: Connect Your AI Tool

Point your AI tool at the MCP endpoint. No API key, no signup.

Claude Code

Add to your .mcp.json (or run claude mcp add):

{
  "mcpServers": {
    "relational-tech": {
      "type": "streamable-http",
      "url": "https://mcp.relationaltechproject.org/mcp"
    }
  }
}

Claude Desktop

Settings → Developer → Edit Config, then add the same block above.

Cursor, Windsurf, Zed, anything else MCP-compatible

Point it at https://mcp.relationaltechproject.org/mcp using Streamable HTTP transport.

Once you're connected

Try invoking the practice-guide prompt first — it puts your AI into a Neighboring Commons practice-guide stance for the rest of the conversation: relationships-first, asset-based, citing practitioners by name, calibrating confidence honestly, inviting contribution.

Then ask things like:

  • "Help me design a fix-it fair for my neighborhood"
  • "I want to start a mutual aid pod on my block — where do I begin?"
  • "What's microsolidarity, and how does it differ from mutual aid?"
  • "How do I host a block party? What does Vanessa Elias do at Block Party USA?"
  • "I'm feeling burned out from community organizing — what do practitioners recommend?"

The server will surface relevant recipes, frameworks, methodology, and practitioner references, with attribution and source URLs so you can read the full work.


What's Inside

Resources (RTP methodology)

Nine RTP methodology docs are exposed as MCP resources at stable URIs. Content is fetched live from the commons on each request — update once in the commons, see it everywhere.

Resource URIWhat It Contains
rtp://knowledge/core-principlesTechnology accountable to people, the river metaphor, relationships first, asset-based approach, speed of trust
rtp://knowledge/relational-tech-practiceThe four dimensions: purpose, process (embedded design), math (1:100), path (scale deep, spread horizontal)
rtp://knowledge/three-layersNeighborhood infrastructure layers — relational, information, action — with the Outer Sunset as reference
rtp://knowledge/builder-spectrumFive stages of a builder's journey: curious → experimenting → building → sustaining → scaling
rtp://knowledge/measurementMeasuring what matters: agency, belonging, and trust
rtp://knowledge/embedded-designComplete guide to the embedded design methodology
rtp://knowledge/playbooksStep-by-step playbooks: communication channels, gatherings, calendars, mutual aid, asset mapping
rtp://knowledge/challengesNavigating trust, burnout, scale, access, language barriers, conflict, momentum
rtp://knowledge/networkRTP network, adjacent movements, connection patterns for builders

Tools (commons API)

ToolWhat It Does
search-studio-libraryFull-text ranked search across the commons (recipes, frameworks, methodology, references, tools, stories). Filterable by kind.
get-tool-detailsFull body + community notes + linked items for one item by name match
find-patterns-by-contextDescribe a builder's situation (with stage/need); returns matched commons items + stage-specific guidance
suggest-contributionGuided framework for shaping a builder's experience into a commons contribution
get-network-updatesRecent activity across the relational tech network (from the Watcher feed)

Prompts (guided workflows)

PromptWhat It Does
practice-guideStart here. Adopt the Neighboring Commons practice-guide stance for the conversation — relationships-first, asset-based, cite practitioners, calibrate confidence, invite contribution.
design-neighborhood-toolGuided embedded design process for creating neighborhood-scale tools
assess-relational-soilAssess agency, belonging, and trust in a neighborhood
create-builder-action-planPersonalized action plan: this week, this month, this quarter
remix-existing-toolAdapt an existing tool or recipe for a new neighborhood

Endpoints

PathDescription
/Landing page with connection instructions
/mcpMCP Streamable HTTP endpoint (what AI tools connect to)
/healthHealth check returning JSON status, version, and source

Configuration

The server reads its commons connection from environment variables, all with sensible defaults so it works out of the box:

Env VarDefaultPurpose
RTP_COMMONS_URLhttps://odowkowcinyoxejyzhwl.supabase.coCommons Supabase project URL
RTP_COMMONS_ANON_KEY(baked in — public anon key)Read-only access (RLS enforces canonical-only)
PORT3000HTTP port (most hosts set automatically)
RTP_MCP_TRANSPORThttpSet to stdio for local CLI mode

Deploying

Standard Node 18+ HTTP server. npm install && npm start is all you need.

Railway

  1. Connect this repo at railway.app
  2. Auto-detects Node.js — deploy
  3. Endpoint at https://your-app.up.railway.app/mcp

Render

  1. New Web Service at render.com
  2. Build: npm install && npm run build
  3. Start: npm start

Anywhere Node 18+

Respects PORT. No other configuration required.


How It Fits Together

                     ┌─────────────────────────────────────┐
                     │  RTP COMMONS (Supabase)             │
                     │  275+ canonical items               │
                     │  commons_items + embeddings +       │
                     │  full-text search RPCs              │
                     └─────────────┬───────────────────────┘
                                   │ read (anon key, RLS)
                          ┌────────▼────────┐
                          │ rt-mcp-server   │
                          │ v0.2.0          │
                          │ (this repo)     │
                          │                 │
                          │ mcp.relational  │
                          │ techproject.org │
                          └────────┬────────┘
                                   │ Streamable HTTP
                                   │
                ┌──────────────────┼──────────────────┐
                │                  │                  │
          Claude Code           Cursor          Claude Desktop
                                                 + any MCP client

The commons also powers Sidekick in the Relational Tech Studio. Connect your AI to this server and you have access to the same library Sidekick draws from — plus the practice-guide prompt and the methodology resources at stable URIs.


Contributing

This server is open source and part of the broader relational tech commons. PRs welcome.

The most useful contributions right now:

  • Better commons content: contribute recipes, stories, or community notes via studio.relationaltechproject.org/library — the commons grows from there
  • New MCP tools or prompts: if you've found a useful query pattern, propose it
  • Bug reports: anything broken in how the server formats responses, handles errors, or surfaces items
  • Civic commons integrations: connecting more knowledge sources beyond what's in the commons today

License

MIT — use freely, remix generously, tend your garden.


Made by the Relational Tech Project · Studio · hello@relationaltechproject.org

Builder

Josh Nesbit – co-founder of Relational Tech Project, building with neighbors in the Outer Sunset in SF. Reach me by email: josh@relationaltechproject.org

Ver o original no GitHub

Bom para

Relacionados