@creedspace/mcp-server

creedspace-mcp-server

Universal MCP server for Creed Space - AI safety guardrails in 10 seconds.

Quick Start

# Run immediately with npx (no installation required)
npx creedspace-mcp-server --persona ambassador

# Test API connection
npx creedspace-mcp-server test

What is Creed Space?

Creed Space provides personalized AI safety guardrails through Constitutional AI personas. Each persona enforces specific values and behaviors, ensuring AI assistants operate within defined ethical boundaries.

• 🛡️ 96.4% reduction in harmful AI outputs
• 🎯 100% refusal on dangerous prompts
• 🚀 10-second setup with any MCP-compatible AI

Available Personas

Persona	Icon	Purpose
Ambassador	🤝	Professional communication
Nanny	👶	Child-safe interactions
Sentinel	🛡️	Privacy and security focus
Godparent	🕊️	Religious and ethical guidance
Muse	🎨	Creative exploration
Anchor	⚓	Reality grounding

Installation

Option 1: Use with npx (Recommended)

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

Option 2: Global Installation

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

Option 3: Project Dependency

npm install @creedspace/mcp-server

Claude Desktop Integration

Add to your claude_desktop_config.json:

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

Then restart Claude Desktop to load the Creed Space guardrails.

Configuration

Environment Variables

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

Command Line Options

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

Configuration File

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

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

Available MCP Tools

The server provides these tools to MCP clients:

• get_constitution - Get merged constitution for a persona
• list_personas - List all available personas
• set_persona - Switch active persona
• get_uvc_qualities - Get desired/disliked/never qualities
• get_system_prompt - Get complete system prompt
• preview_export - Preview export configuration
• search_constitutions - Search constitution library
• clear_cache - Clear local cache

Programmatic Usage

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');

Platform Integration Examples

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"]
)

Testing

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

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

Offline Mode

The server includes intelligent caching for offline usage:

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

Development

# Clone the repository
git clone https://github.com/nellwatson/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

API Documentation

Full API documentation available at https://api.creed.space/docs

Support

• 🌐 Website: https://www.creed.space
• 📧 Email: [e-mail]
• 🐛 Issues: GitHub Issues
• 💬 Discord: Join our community

License

MIT © Nell Watson

Building critical AI safety infrastructure that shapes autonomous AI-human value interaction.