What is MCP? A Beginner's Guide to AI Tool Protocols
By CKB Team
You've heard about MCP. Your AI coding assistant supports it. But what actually is it, and why should you care?
This guide explains MCP from the ground up—no prior knowledge required.
The Problem MCP Solves
Imagine you're using an AI coding assistant. You ask: "What functions call handlePayment?"
The AI needs to search your codebase. But how? Different tools have different APIs:
- VS Code has one way to search files
- Cursor has another
- Claude Code has its own approach
- Neovim plugins work differently
If you're building a code intelligence tool (like CKB), you'd need to write separate integrations for every editor. That's a lot of work, and it fragments the ecosystem.
MCP fixes this.
What MCP Is
MCP stands for Model Context Protocol. It's a standard way for AI assistants to connect to external tools.
Think of it like USB for AI tools:
- Before USB, every device had its own connector
- USB created one standard that works everywhere
- Now any device works with any computer
MCP does the same for AI:
- Before MCP, every AI had its own tool format
- MCP creates one standard that works everywhere
- Now any tool works with any AI assistant
How MCP Works
MCP defines three things:
1. Tools
Tools are actions the AI can take. For example, CKB provides tools like:
searchSymbols - Find functions, classes, variables
getCallGraph - See what calls what
prepareChange - Analyze impact before changing code
Each tool has a name, description, and parameters. The AI reads these and knows how to use them.
2. Resources
Resources are data the AI can access. For example:
file://src/main.go - A source file
ckb://symbols/User - Information about the User type
Resources are read-only—the AI can look but not modify.
3. Prompts
Prompts are pre-written instructions for common tasks:
"Explain this codebase" - Guided exploration
"Review this PR" - Code review workflow
Prompts help users get started without knowing exactly what to ask.
Why MCP Matters for You
1. Tool Choice Freedom
With MCP, you're not locked into one AI assistant. CKB works with:
- Claude Code
- Cursor
- Windsurf
- VS Code (with MCP extensions)
- Zed
- Any MCP-compatible tool
Switch assistants anytime. Your tools come with you.
2. Better AI Capabilities
Without MCP, AI assistants are limited to what's built in. With MCP, they can:
- Query semantic code indexes (via CKB)
- Access databases
- Call APIs
- Read documentation
- And much more
The AI becomes extensible.
3. Privacy Control
MCP tools run locally. Your code doesn't go to external servers (unless you choose tools that do). CKB indexes your code on your machine—the AI queries that local index.
MCP in Practice
Here's what using an MCP tool looks like:
Step 1: Install the Tool
npm install -g @tastehub/ckb
Step 2: Configure Your AI Assistant
Add the tool to your assistant's config. For example, in Claude Code:
{
"mcpServers": {
"ckb": {
"command": "npx",
"args": ["@tastehub/ckb", "mcp"]
}
}
}
Step 3: Use It Naturally
Just talk to your AI:
You: "What functions call handlePayment?"
AI: [uses CKB's getCallGraph tool]
"handlePayment is called by:
- CheckoutController.process() at checkout.go:45
- RefundHandler.execute() at refund.go:78
It has 3 callees: validateCard, chargeCard, sendReceipt."
The AI automatically uses the right tool. You don't need to know the technical details.
Common MCP Questions
"Do I need to learn MCP to use CKB?"
No. MCP is the plumbing—you don't need to understand it to benefit from it. Install CKB, configure your AI assistant, and start asking questions.
"Is MCP secure?"
MCP tools run locally with your permissions. They can only do what you allow. CKB, for example, only reads your code and git history—it can't modify files or access the network.
"What if my AI assistant doesn't support MCP?"
Most modern AI coding assistants support MCP:
- Claude Code ✓
- Cursor ✓
- Windsurf ✓
- VS Code (via extensions) ✓
- Zed ✓
If yours doesn't, check for updates—MCP support is being added rapidly.
"Can I build my own MCP tools?"
Yes! MCP is an open standard. If you have a service you want your AI to access, you can build an MCP server for it. See the MCP documentation for details.
CKB: An MCP Tool for Code Intelligence
CKB is one example of what MCP enables. It provides:
- 90+ tools for code navigation, impact analysis, and understanding
- Semantic search that understands code structure, not just text
- Cross-repository queries for complex codebases
- Ownership tracking to find the right reviewers
All accessible through natural conversation with your AI assistant.
Getting Started
Ready to try MCP with CKB?
# Install CKB
npm install -g @tastehub/ckb
# Initialize in your project
cd /your/project
ckb init
# Auto-configure your AI assistant
ckb setup
That's it. Your AI assistant now has semantic code understanding.
Learn More
Links: