Teddy Svoronos MCP Server

A remote MCP (Model Context Protocol) server that provides Claude access to blog posts and pages from teddysvoronos.com.

Features

Resources

• posts://all - All blog posts with full content
• posts://manifest - Site metadata and post summaries
• pages://all - Static pages (Teaching, Publications, etc.)
• tags://list - Available tags with post counts

Tools

• get_posts_by_tag - Filter posts by tag (pedagogy, productivity, research, ai, keynote, zoom, etc.)
• search_posts - Search posts by keyword

Deployment to Vercel

Step 1: Deploy

1. Go to vercel.com and sign in
2. Click “Add New Project”
3. Import your GitHub repository (tsvoronos/tsvoronos.github.io)
4. Important: Set the Root Directory to mcp-server
5. Click Deploy

Vercel will automatically build and deploy your MCP server.

Step 2: Add Custom Domain (Optional)

1. In your Vercel project, go to Settings → Domains
2. Add mcp.teddysvoronos.com
3. Vercel will show you DNS configuration instructions
4. At your domain registrar, add a CNAME record:
   • Name: mcp
   • Value: cname.vercel-dns.com
5. Wait a few minutes for DNS propagation

Step 3: Configure Claude

Add the MCP server to your Claude configuration:

Claude Desktop

Edit ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "teddy-site": {
      "url": "https://mcp.teddysvoronos.com/api/mcp"
    }
  }
}

Claude Code

Add to your MCP settings:

{
  "teddy-site": {
    "url": "https://mcp.teddysvoronos.com/api/mcp"
  }
}

Usage Examples

Once configured, you can ask Claude things like:

• “What posts does Teddy have about pedagogy?”
• “Search Teddy’s blog for two-stage exams”
• “What topics does Teddy write about?”
• “Show me Teddy’s teaching page”

API Endpoints

Development

# Install dependencies
npm install

# Run locally
npm run dev

# Type check
npm run lint

Architecture

Claude → MCP Server (Vercel) → JSON API (GitHub Pages)
                ↓
        teddysvoronos.com/api/posts.json
        teddysvoronos.com/api/tags/*.json
        etc.

The MCP server acts as a bridge, fetching from the existing static JSON API and presenting it in MCP format.

License

MIT