Creed Space

Diretrizes de segurança Constitutional-AI para qualquer LLM: personas e constituições do Creed Space via 16 ferramentas stdio (npx @creedspace/mcp-server).

Documentação

creedspace-mcp-server

Servidor MCP universal para Creed Space - salvaguardas de segurança de IA em 10 segundos.

npm version smithery badge License: MIT

Disponível em

O servidor é publicado nos catálogos canônicos de MCP, para que clientes cientes de registro possam descobri-lo e instalá-lo diretamente — ou usar qualquer comando em Início Rápido abaixo.

  • npm@creedspace/mcp-server, o pacote para o qual todos os caminhos de instalação resolvem.
  • Registro Oficial MCPio.github.Creed-Space/creedspace-mcp-server.
  • GitHub — código-fonte, problemas e o manifesto server.json.
  • Smitherynell/creedspace, um endpoint HTTP Streamable com gateway frontal.

Também em expansão pelo ecossistema MCP mais amplo: mcp.directory, mcpservers.org, PulseMCP (via ingestão do registro) e mcp.so.

Início Rápido

# STDIO transport (Claude Desktop, OpenAI Codex)
npx @creedspace/mcp-server --persona ambassador

# HTTP transport (OpenAI Agents SDK)
npx @creedspace/mcp-server --transport http --port 3100

# Test API connection
npx @creedspace/mcp-server test

O que é Creed Space?

O Creed Space fornece salvaguardas personalizadas de segurança de IA por meio de personas de IA Constitucional. Cada persona impõe valores e comportamentos específicos, garantindo que os assistentes de IA operem dentro de limites éticos definidos.

  • 🛡️ Reduz saídas prejudiciais de IA por meio de avaliação constitucional de cada resposta
  • 🎯 Recusa prompts perigosos de acordo com os valores da persona ativa
  • 🚀 Configuração em 10 segundos com qualquer IA compatível com MCP

Personas Disponíveis

PersonaÍconePropósito
Ambassador🤝Comunicação profissional
Nanny👶Interações seguras para crianças
Sentinel🛡️Foco em privacidade e segurança
Godparent🕊️Orientação religiosa e ética
Muse🎨Exploração criativa
AnchorFundamentação na realidade

Instalação

Opção 1: Usar com npx (Recomendado)

# No installation needed - just run!
npx @creedspace/mcp-server --persona ambassador

Opção 2: Instalação Global

npm install -g @creedspace/mcp-server
creedspace-mcp --persona ambassador

Opção 3: Dependência do Projeto

npm install @creedspace/mcp-server

Integração com Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "creedspace": {
      "command": "npx",
      "args": ["@creedspace/mcp-server", "--persona", "ambassador"]
    }
  }
}

Em seguida, reinicie o Claude Desktop para carregar as salvaguardas do Creed Space.

Configuração

Variáveis de Ambiente

# .env file
CREEDSPACE_API_URL=https://api.creed.space
CREEDSPACE_API_KEY=your-api-key-here  # Optional
CREEDSPACE_DEFAULT_PERSONA=ambassador

Opções de Linha de Comando

creedspace-mcp \
  --persona ambassador \
  --url https://api.creed.space \
  --api-key YOUR_KEY \
  --cache-ttl 300000 \
  --offline

# HTTP Transport Options
creedspace-mcp \
  --transport http \
  --port 3100 \
  --host localhost \
  --api-key YOUR_KEY \
  --cors \
  --cors-origin http://localhost:3000 \
  --stateless

Tipos de Transporte

TransporteCaso de UsoPlataformas
stdio (padrão)Comunicação local por subprocessoClaude Desktop, OpenAI Codex
httpServidor HTTP para conexões remotas/locaisOpenAI Agents SDK, integrações personalizadas

Arquivo de Configuração

# Generate example configs
creedspace-mcp --generate-config

# Use config file
creedspace-mcp --config creedspace.json

Ferramentas MCP Disponíveis

O servidor fornece 16 ferramentas para clientes MCP:

Constituições

  • get_constitution - Obter a constituição mesclada para uma persona
  • get_constitution_by_id - Obter uma constituição específica por ID
  • search_constitutions - Pesquisar na biblioteca de constituições

Personas

  • list_personas - Listar todas as personas disponíveis
  • set_persona - Alternar a persona ativa
  • get_active_persona - Obter a persona atualmente ativa
  • get_uvc_qualities - Obter qualidades desejadas/não gostadas/nunca
  • get_system_prompt - Obter um prompt de sistema completo da persona
  • preview_export - Visualizar a configuração de exportação

Salvaguardas de tempo de execução

  • adjudicate - Obter um kernel de decisão de política para uma solicitação
  • attest_response - Validar uma resposta contra o credo ativo
  • get_anchor - Obter uma âncora compacta de regras inegociáveis
  • heartbeat - Reancoragem periódica para evitar desvio de contexto
  • clear_cache - Limpar o cache local

Handshake de valor em múltiplas escalas

  • perform_multi_scale_handshake - Handshake de valor entre N partes em escalas micro/meso/macro
  • get_scale_attestation - Obter um registro de atestado com cadeia de hash

Uso Programático

import { CreedSpaceMCPServer } from '@creedspace/mcp-server';

// Start server programmatically
const server = new CreedSpaceMCPServer({
  persona: 'ambassador',
  apiUrl: 'https://api.creed.space',
  cacheEnabled: true
});

await server.start();
// Use the API client directly
import { CreedSpaceClient } from '@creedspace/mcp-server';

const client = new CreedSpaceClient();
const personas = await client.getPersonas();
const constitution = await client.getMergedConstitution('ambassador');

Exemplos de Integração de Plataforma

OpenAI Agents SDK (Transporte HTTP)

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

# Start the server first:
# npx @creedspace/mcp-server --transport http --port 3100

server = MCPServerStreamableHttp(
    url="http://localhost:3100/mcp",
    name="creedspace"
)

agent = Agent(
    name="safe-agent",
    tools=[server.get_tools()]
)

# The agent now has access to Creed Space safety tools

OpenAI Codex (Transporte STDIO)

Adicione ao ~/.codex/config.toml:

[mcp_servers.creedspace]
command = "npx"
args = ["@creedspace/mcp-server", "--persona", "ambassador"]

[mcp_servers.creedspace.env]
CREEDSPACE_API_URL = "https://api.creed.space"

VS Code / Cursor

{
  "mcp.servers": {
    "creedspace": {
      "command": "npx",
      "args": ["@creedspace/mcp-server", "--persona", "ambassador"]
    }
  }
}

Continue.dev

{
  "models": [{
    "provider": "openai",
    "mcp_servers": [{
      "command": "npx",
      "args": ["@creedspace/mcp-server"]
    }]
  }]
}

LangChain

from langchain.tools import MCPTool

creedspace = MCPTool(
    command="npx",
    args=["@creedspace/mcp-server", "--persona", "ambassador"]
)

Testes

# Test API connection
npx @creedspace/mcp-server test

# Test with specific URL
npx @creedspace/mcp-server test --url http://localhost:8000

Modo Offline

O servidor inclui cache inteligente para uso offline:

# Enable offline mode with cached data
creedspace-mcp --offline --persona ambassador

Desenvolvimento

# Clone the repository
git clone https://github.com/Creed-Space/creedspace-mcp-server.git
cd creedspace-mcp-server

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

Documentação da API

Documentação completa da API disponível em https://api.creed.space/api-docs

Suporte

Licença

MIT © Nell Watson


Construindo infraestrutura crítica de segurança de IA que molda a interação de valor autônoma entre IA e humanos.