Information
# MCPC
[](https://jsr.io/@mcpc/core)
[](https://www.npmjs.com/package/@mcpc-tech/core)
**Build agentic MCP servers by composing existing MCP tools.**
MCPC is the SDK for building agentic MCP (Model Context Protocol) Servers. You
can use it to:
1. **Create Powerful Agentic MCP Tools:** Simply describe your vision in text
and reference tools from the
[expanding MCP community](https://registry.modelcontextprotocol.io/docs#/operations/list-servers).
As standard MCP tools, your agents work everywhere and collaborate
seamlessly.
2. **Fine-Tune Existing Tools:** Flexibly modify existing tool descriptions and
parameters, or wrap and filter results to precisely adapt them to your
specific business scenarios.
3. **Build Multi-Agent Systems:** By defining each agent as a MCP tool, you can
compose and orchestrate them to construct sophisticated, collaborative
multi-agent systems.
## Key Features
- **Portability and agent interoperability**: Build once, run everywhere as MCP
tools - agents work across all MCP clients and can discover and collaborate
with each other through standard MCP interfaces
- **Simple composition and fine-tuning**: Compose MCP servers as building
blocks, select and customize tools, or modify their descriptions and
parameters
- **Two agentic tool modes**: Interactive (agentic) or autonomous (sampling)
- **Logging and tracing**: Built-in MCP logging and OpenTelemetry tracing
support
## Quick Start
### Three Ways to Get Started
#### 1. Use the Website (Fastest)
Visit **[mcpc.tech](https://mcpc.tech)** to browse servers from the official MCP
registry, discover tools, and generate ready-to-use agents.
#### 2. Use the Agent (Interactive)
Let AI help you discover servers and build agents:
**Add to your MCP client:**
\`\`\`json
\{
"mcpServers": \{
"mcpc-builder-agent": \{
"command": "npx",
"args": ["-y", "@mcpc-tech/builder", "mcpc-builder-agent"]
\}
\}
\}
\`\`\`
#### 3. Write Code (Full Control)
Use the SDK directly for complete customization. See examples below.
---
### Installation
\`\`\`bash
# npm (from npm registry)
npm install @mcpc-tech/core
# npm (from jsr)
npx jsr add @mcpc/core
# deno
deno add jsr:@mcpc/core
# pnpm (from npm registry)
pnpm add @mcpc-tech/core
# pnpm (from jsr)
pnpm add jsr:@mcpc/core
\`\`\`
Or run directly with the CLI (no installation required):
\`\`\`bash
# Run with remote configuration
npx -y @mcpc-tech/cli --config-url \
"https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/codex-fork.json"
\`\`\`
### Examples: Create a Simple Codex/Claude Code Fork
Build your own Codex or Claude Code fork in minutes:
\`\`\`typescript
import \{ type ComposeDefinition, mcpc \} from "@mcpc/core";
import \{ StdioServerTransport \} from "@modelcontextprotocol/sdk/server/stdio.js";
// 1. Define MCP server dependencies
const deps: ComposeDefinition["deps"] = \{
mcpServers: \{
"desktop-commander": \{
command: "npx",
args: ["-y", "@wonderwhy-er/desktop-commander@latest"],
transportType: "stdio",
\},
lsmcp: \{
command: "npx",
args: ["-y", "@mizchi/lsmcp", "-p", "tsgo"],
transportType: "stdio",
\},
github: \{
transportType: "streamable-http",
url: "https://api.githubcopilot.com/mcp/",
headers: \{
Authorization: \`Bearer $\{process.env.GITHUB_PERSONAL_ACCESS_TOKEN\}\`,
\},
\},
\},
\};
// 2. Write agent description with tool references
const description = \`
You are a coding assistant with advanced capabilities.
Your capabilities include:
- Reading and writing files
- Searching the codebase using language server features
- Executing terminal commands to build, test, and run projects
- Interacting with GitHub to create pull requests and manage issues
To perform these actions, you must use the following tools:
- To execute a shell command: