MCPHub Lab
MCPHub LabRegistrykentcdodds/kody
kentcdodds

kentcdodds/kody

Built by kentcdodds • 26 stars

Visit Repository

What is kentcdodds/kody?

An experimental personal assistant platform built on Cloudflare Workers and MCP

How to use kentcdodds/kody?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add kentcdodds/kody using the following command: npx @modelcontextprotocol/kentcdodds-kody 4. Restart the client and verify the new tools are active.
🛡️ Scoped (Restricted)
npx @modelcontextprotocol/kentcdodds-kody --scope restricted
🔓 Unrestricted Access
npx @modelcontextprotocol/kentcdodds-kody

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified Standard Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

kentcdodds/kody FAQ

Q

Is kentcdodds/kody safe?

Yes, kentcdodds/kody follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is kentcdodds/kody up to date?

kentcdodds/kody is currently active in the registry with 26 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for kentcdodds/kody?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub
<div align="center"> <img src="./packages/worker/public/logo.png" alt="kody logo" width="400" /> <p> <strong>Your assistant's home — the memory, keys, code, and automations your AI agent keeps, portable across every MCP host. Built on Cloudflare Workers.</strong> </p> <p> <a href="https://github.com/kentcdodds/kody/actions/workflows/deploy.yml"><img src="https://img.shields.io/github/actions/workflow/status/kentcdodds/kody/deploy.yml?branch=main&style=flat-square&logo=github&label=CI" alt="Build Status" /></a> <img src="https://img.shields.io/badge/TypeScript-5.9-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /> <img src="https://img.shields.io/badge/Node-26-5FA04E?style=flat-square&logo=node.js&logoColor=white" alt="Node 26" /> <img src="https://img.shields.io/badge/Cloudflare-Workers-F38020?style=flat-square&logo=cloudflare&logoColor=white" alt="Cloudflare Workers" /> <img src="https://img.shields.io/badge/Remix-3.0_beta-000000?style=flat-square&logo=remix&logoColor=white" alt="Remix" /> </p> </div>

Kody is your assistant's home—the memory, keys, code, and automations your AI agent keeps, portable across every MCP host. Built on Cloudflare Workers and the Model Context Protocol (MCP), it ships a Remix UI, Worker-based request routing, package runtime plumbing, and OAuth-protected MCP endpoints. The project favors a compact MCP surface with powerful search and Code Mode execute flows over a large static tool catalog.

Kody is a multi-user personal assistant: each signed-in user gets a fully isolated assistant (packages, jobs, secrets, values, memories, and related state). Tests and fixtures may seed deterministic local accounts, but no account is privileged at runtime. The repo follows several epicflare starter conventions.

The repo is organized as an Nx monorepo, with shared modules in packages/shared (@kody-internal/shared), the main app worker under packages/worker, and mock Workers under packages/mock-servers/*.

Quick Start

npm install
npm run dev

The dev server runs at localhost:8787. Wrangler handles the local Cloudflare Workers runtime and D1 database automatically.

To scaffold a new project from the epicflare template instead, run npx create-epicflare.

See docs/contributing/getting-started.md for the full setup paths and expectations. Contributors and agents should start with AGENTS.md for repo-specific guidance.

If you are trying to understand what this repository is for, start with docs/contributing/project-intent.md.

Tech Stack

LayerTechnology
RuntimeCloudflare Workers
UI FrameworkRemix 3 (beta)
Package Managernpm
WorkspaceNx + npm workspaces
DatabaseCloudflare D1
Session/OAuthCloudflare KV
MCP StateDurable Objects
E2E TestingPlaywright
Bundleresbuild

Scope

  • Open-source personal assistant platform, not a general-purpose agent harness
  • MCP-first architecture intended to work across compatible AI agent hosts
  • Compact MCP surface area preferred over a large static tool inventory
  • ChatGPT is a likely primary host target, while keeping the server usable from other MCP hosts where practical

How It Works

Request → packages/worker/src/index.ts
              │
              ├─→ OAuth handlers
              ├─→ MCP endpoints
              ├─→ Static assets (`packages/worker/public/`)
              └─→ Server router → Remix components
  • packages/worker/src/index.ts is the entrypoint for Cloudflare Workers
  • OAuth requests are handled first, then MCP requests, then static assets
  • Non-asset requests fall through to the server handler and router
  • Client assets are bundled into packages/worker/public/ and served via the ASSETS binding

Documentation

DocumentDescription
docs/contributing/getting-started.mdSetup, environment variables, deploy
docs/contributing/environment-variables.mdAdding new env vars
docs/contributing/cloudflare-offerings.mdOptional Cloudflare integrations
docs/contributing/project-intent.mdScope, goals, and non-goals
docs/contributing/index.mdDeveloping and extending Kody
docs/use/index.mdUsing Kody over MCP
docs/contributing/setup.mdLocal development and verification
<div align="center"> <sub>Built with ❤️ by <a href="https://epicweb.dev">Epic Web</a></sub> </div>

Global Ranking

2.6
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "kentcdodds-kody": { "command": "npx", "args": ["kentcdodds-kody"] } } }