ContextMCP

1# ContextMCP
2 
3<p align="left">
4  <a href="https://discord.gg/bYqAp4ayYh">
5    <img src="https://img.shields.io/discord/1305511580854779984?label=Join%20Discord&logo=discord" alt="Join Discord" />
6  </a>
7  <a href="https://twitter.com/dodopayments">
8    <img src="https://img.shields.io/twitter/follow/dodopayments?label=Follow&style=social" alt="Twitter Follow" />
9  </a>
10</p>
11 
12**Self-hosted MCP server for your documentation.** Index your documentation from across the sources and serve it via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) and REST API.
13 
14## Quick Start
15 
16```bash
17# Scaffold a new project
18npx contextmcp init my-docs-mcp
19 
20# Follow the prompts, then:
21cd my-docs-mcp
22npm install
23 
24# Configure your API keys
25cp .env.example .env
26# Edit .env with your PINECONE_API_KEY and OPENAI_API_KEY
27 
28# Configure your documentation sources
29# Edit config.yaml
30 
31# Index your documentation
32npm run reindex
33 
34# Edit the cloudflare-worker
35# Deploy the MCP server
36cd cloudflare-worker
37npm install
38npm run deploy
39```
40 
41## What is ContextMCP?
42 
43ContextMCP creates a searchable knowledge base from your documentation that AI assistants can query via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
44 
45### Supported Content Types
46 
47| Parser     | Content Types         | Examples                       |
48| ---------- | --------------------- | ------------------------------ |
49| `mdx`      | MDX/JSX documentation | Mintlify, Fumadocs, Docusaurus |
50| `markdown` | Plain Markdown files  | READMEs, CHANGELOGs            |
51| `openapi`  | OpenAPI/Swagger specs | API reference docs             |
52 
53### How It Works
54 
551. **Parse** - Extract content from your docs, APIs, and READMEs
562. **Chunk** - Split into semantic chunks optimized for search
573. **Embed** - Generate embeddings using OpenAI
584. **Store** - Upload to Pinecone vector database
595. **Search** - Query via MCP from AI assistants
60 
61## Repository Structure
62 
63```
64contextmcp/
65├── packages/
66│   ├── cli/              # npx contextmcp (npm package)
67│   ├── template/         # Project template (scaffolded to users)
68│   └── website/          # contextmcp.ai documentation site
69└── deployments/
70    └── dodopayments/     # Dodo Payments specific deployment
71```
72 
73## Packages
74 
75| Package             | Description          | Published            |
76| ------------------- | -------------------- | -------------------- |
77| `packages/cli`      | CLI scaffolding tool | ✅ npm: `contextmcp` |
78| `packages/template` | Project template     | (copied by CLI)      |
79| `packages/website`  | Documentation site   | (deployed to Vercel) |
80 
81## Development
82 
83### Prerequisites
84 
85- Node.js 18+
86 
87### Setup
88 
89```bash
90# Install all dependencies
91npm install
92 
93# Development
94npm run dev:website     # Run website locally
95npm run dev:cli         # Watch CLI for changes
96 
97# Build
98npm run build:website   # Build website
99npm run build:cli       # Build CLI
100 
101# Type checking
102npm run typecheck       # Check all packages
103```
104 
105## Documentation
106 
107Visit [contextmcp.ai/docs](https://contextmcp.ai/docs) for full documentation.
108 
109## Contributing
110 
111We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute to this project.
112 
113## License
114 
115This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
116