mcpc-tech/mcpc
If you are the rightful owner of mcpc and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
MCPC is a platform that allows users to build scalable agentic MCP servers using a single prompt, leveraging thousands of dependent MCPs.
MCPC
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:
- Create Powerful Agentic MCP Tools: Simply describe your vision in text and reference tools from the expanding MCP community. As standard MCP tools, your agents work everywhere and collaborate seamlessly.
- 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.
- 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
Installation
# 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):
# Run with remote configuration
npx -y deno run -A jsr:@mcpc/cli/bin --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:
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: <tool name="desktop-commander.execute_command" />
- To read a file's content: <tool name="desktop-commander.read_file" />
- To write content to a file: <tool name="desktop-commander.write_file" />
- To find symbol definitions: <tool name="lsmcp.definition" />
- To create a GitHub pull request: <tool name="github.create_pull_request" />
`;
// 3. Create and start the server
const server = await mcpc(
[
{
name: "coding-agent",
version: "0.1.0",
},
{ capabilities: { tools: {}, sampling: {} } },
],
[
{
name: "coding-agent",
options: {
mode: "agentic",
},
description,
deps,
},
],
);
const transport = new StdioServerTransport();
await server.connect(transport);
💡 Complete Example: See the full for a step-by-step walkthrough.
Quick Start with CLI
For a faster way to get started, use the CLI to load configuration from a remote URL:
# Set your GitHub token
export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_your_token_here"
# Load configuration from URL
npx -y deno run -A jsr:@mcpc/cli/bin --config-url \
"https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/codex-fork.json"
See for more configuration options.
How It Works
Three simple steps:
- Define dependencies - List the MCP servers you want to use
- Write agent description - Describe what your agent does and reference tools
- Create server - Use
mcpc()to build and connect your server
Execution Modes
Agentic Mode (default) - Interactive tool calls step by step
{
mode: "agentic";
} // LLM calls tools interactively
Sampling Mode - Autonomous execution in compatible clients
{ options: { mode: "agentic", sampling: true } } // Runs autonomously in VS Code
Documentation
- - Installation and first steps
- - Complete tutorial
- - Using the MCPC CLI
- - MCP logging and OpenTelemetry tracing
- - Real-world use cases
- - Common questions and answer
Using with AI Clients
Add your server to Claude Desktop, VS Code, or any MCP-compatible client:
{
"mcpServers": {
"my-agent": {
"command": "npx",
"args": ["tsx", "my-server.ts"]
}
}
}
Examples
See working examples in the or check out the .
Contributing
We welcome contributions! See for details.
License
MIT License - see for details.
