@ccwiki/mcp

> MCP server that gives Claude Code instant access to your codebase context via ccwiki.ai

What This Does

Once installed, Claude Code automatically has deep understanding of any repository you've analyzed on ccwiki.ai:

- No more re-explaining your codebase every session
- No more duplicating code that already exists
- No more guessing at patterns and conventions
- Instant context for any task you're working on

Quick Start

$3

Visit ccwiki.ai and analyze your repository. This takes ~10 minutes and creates comprehensive documentation.

$3

Go to ccwiki.ai/settings and generate an API key.

$3

Add to your Claude Code config (~/.claude/config.json):

``json
{
"mcpServers": {
"ccwiki": {
"command": "npx",
"args": ["@ccwiki/mcp"],
"env": {
"CCWIKI_API_KEY": "your-api-key-here"
}
}
}
}
`

$3

Just start working. Claude Code now automatically has context:

`
> "Add a new API endpoint for user settings"

Claude knows:
- Where your existing endpoints are
- What patterns they follow
- What middleware to use
- What utilities exist to reuse
- What conventions to follow
`

Available Tools

Once connected, Claude Code has access to these tools:

| Tool | Description |
|------|-------------|
| ccwiki_get_context | Get relevant context for a task (patterns, files, conventions) |
| ccwiki_find_files | Find files by purpose or layer |
| ccwiki_get_conventions | Get coding conventions and anti-patterns |
| ccwiki_quickstart | Get a 60-second codebase overview |
| ccwiki_search | Search documentation for specific topics |
| ccwiki_list_repos | List your analyzed repositories |

How It Works

1. Auto-detection: The MCP server detects which git repository you're in
2. Lookup: It finds the matching analyzed repo on ccwiki.ai
3. Context: It provides relevant context to Claude Code
4. Caching: Responses are cached for fast repeat access

Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| CCWIKI_API_KEY | Your ccwiki API key | Required |
| CCWIKI_API_URL | API base URL | https://api.ccwiki.ai |

Manual Usage

You can also run the server directly:

`bash


Show help

npx @ccwiki/mcp --help

Show version

npx @ccwiki/mcp --version

Run server (for testing)

CCWIKI_API_KEY=xxx npx @ccwiki/mcp
`

Troubleshooting

$3

This means either:
1. You're not in a git repository
2. The repository hasn't been analyzed on ccwiki.ai
3. The git remote URL doesn't match what's on ccwiki

Solution: Make sure the repo is analyzed at ccwiki.ai and you're in the repo directory.

$3

Your API key is invalid or expired.

Solution: Generate a new API key at ccwiki.ai/settings.

$3

Check that Node.js 18+ is installed:

`bash
node --version # Should be 18.x or higher
`

Development

`bash


Install dependencies

npm install

Build

npm run build

Run in development

npm run dev

Type check

npm run typecheck
``

License

MIT

Links

- ccwiki.ai - Analyze your repositories
- Documentation - Full documentation
- GitHub - Source code