mcp-server-setup.md

Context Store MCP Server Setup

Cloud MCP Server Configuration

Once Context Store is deployed to HuggingFace, you can access it from any device using the MCP protocol.

Add to Claude Code

# Add Context Store MCP server
claude mcp add context-store https://your-username-context-store.hf.space

# Verify connection  
claude mcp list

MCP Configuration File

Create or update ~/.claude/mcp.json:

{
  "servers": {
    "context-store": {
      "command": "node",
      "args": ["-e", "
        const https = require('https');
        const readline = require('readline');
        
        const baseUrl = 'https://your-username-context-store.hf.space';
        
        const rl = readline.createInterface({
          input: process.stdin,
          output: process.stdout
        });
        
        rl.on('line', async (input) => {
          try {
            const request = JSON.parse(input);
            
            if (request.method === 'tools/list') {
              console.log(JSON.stringify({
                jsonrpc: '2.0',
                id: request.id,
                result: {
                  tools: [
                    {
                      name: 'add_memory',
                      description: 'Add content to Context Store memory',
                      inputSchema: {
                        type: 'object',
                        properties: {
                          content: { type: 'string', description: 'Content to store' },
                          source: { type: 'string', description: 'Source identifier' }
                        },
                        required: ['content']
                      }
                    },
                    {
                      name: 'search_memory', 
                      description: 'Search Context Store memory',
                      inputSchema: {
                        type: 'object',
                        properties: {
                          query: { type: 'string', description: 'Search query' },
                          limit: { type: 'number', description: 'Max results' }
                        },
                        required: ['query']
                      }
                    }
                  ]
                }
              }));
            }
            
            else if (request.method === 'tools/call') {
              const { name, arguments: args } = request.params;
              
              if (name === 'add_memory') {
                const response = await fetch(`${baseUrl}/api/v1/add`, {
                  method: 'POST',
                  headers: { 'Content-Type': 'application/json' },
                  body: JSON.stringify({
                    episodeBody: args.content,
                    source: args.source || 'mcp'
                  })
                });
                const data = await response.json();
                console.log(JSON.stringify({
                  jsonrpc: '2.0',
                  id: request.id,
                  result: { content: [{ type: 'text', text: JSON.stringify(data) }] }
                }));
              }
              
              else if (name === 'search_memory') {
                const response = await fetch(`${baseUrl}/api/v1/search?q=${encodeURIComponent(args.query)}&limit=${args.limit || 10}`);
                const data = await response.json();
                console.log(JSON.stringify({
                  jsonrpc: '2.0',
                  id: request.id,
                  result: { content: [{ type: 'text', text: JSON.stringify(data) }] }
                }));
              }
            }
          } catch (error) {
            console.log(JSON.stringify({
              jsonrpc: '2.0',
              id: request.id,
              error: { code: -1, message: error.message }
            }));
          }
        });
      "]
    }
  }
}

Alternative: Use Claude Code Built-in MCP

If using Claude Code's MCP capabilities:

# Direct HTTP MCP connection
claude config set mcp.context-store.url "https://your-username-context-store.hf.space"
claude config set mcp.context-store.type "http"

# Test connection
claude mcp test context-store

Usage Examples

Add Memory

claude -m "Add this conversation to my Context Store" --mcp context-store

Search Memory

claude -m "Search my Context Store for React patterns" --mcp context-store

Automatic Memory

# Configure auto-save to Context Store
claude config set memory.provider "context-store"
claude config set memory.auto-save true

Device Setup

Windows

# Install Claude Code
npm install -g @anthropic/claude-code

# Add MCP server
claude mcp add context-store https://your-space.hf.space

macOS/Linux

# Install Claude Code
curl -fsSL https://claude.ai/install.sh | sh

# Add MCP server  
claude mcp add context-store https://your-space.hf.space

Mobile (Termux/iSH)

# Install Node.js and Claude Code
pkg install nodejs-lts
npm install -g @anthropic/claude-code

# Configure MCP
claude mcp add context-store https://your-space.hf.space

Benefits

✅ Universal Access: Same memory on all devices
✅ No Local Setup: No Docker, databases, or services needed
✅ Always Available: HuggingFace handles uptime and scaling
✅ Free Tier: No hosting costs for development usage
✅ MCP Protocol: Standard AI tool integration
✅ Real-time Sync: Changes available immediately everywhere