contextmcp
CLI to scaffold a ContextMCP documentation RAG server
pinned to #f0b908dupdated 3 months ago
Ask your AI client: “install mcps/contextmcp”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install mcps/contextmcpmetahub onboarded this repo on the author's behalf.
If you own github.com/dodopayments/context-mcp on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
61
Last commit
3 months ago
Latest release
published
- #cli
- #cloudflare-workers
- #context
- #context-api
- #context7
- #documentation
- #mcp
- #mcp-server
- #model-context-protocol
- #openai
- #pinecone
- #rag
- #scaffold
- #self-hosted
- #semantic-search
What this server exposes
Surfaces parsed from this server's source at publish time.
Launches: contextmcp
Automated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.f0b908d· 3 months ago
Behavioral checks haven't run yet: the sandbox couldn't execute this artifact (it may need credentials we don't provide, or an unsupported build). An environment limit, not a verdict.
Kind-specific
3 passed1 warningMCP: @modelcontextprotocol/sdk in dependencieswarn
No @modelcontextprotocol/sdk dependency declared
Run `npm i @modelcontextprotocol/sdk` so consumers can audit your stack.
MCP: launch path
bin: contextmcp
MCP: ESM package
"type": "module"
MCP: server surface
0 tools
Release history
1- releasecurrentf0b908dwarn3 months ago
Contents
Self-hosted MCP server for your documentation. Index your documentation from across the sources and serve it via the Model Context Protocol (MCP) and REST API.
Quick Start
# Scaffold a new project
npx contextmcp init my-docs-mcp
# Follow the prompts, then:
cd my-docs-mcp
npm install
# Configure your API keys
cp .env.example .env
# Edit .env with your PINECONE_API_KEY and an embedding provider key
# (OPENAI_API_KEY for provider: openai, or GEMINI_API_KEY for provider: gemini)
# Configure your documentation sources
# Edit config.yaml
# Index your documentation
npm run reindex
# Edit the cloudflare-worker
# Deploy the MCP server
cd cloudflare-worker
npm install
npm run deploy
What is ContextMCP?
ContextMCP creates a searchable knowledge base from your documentation that AI assistants can query via the Model Context Protocol (MCP).
Supported Content Types
| Parser | Content Types | Examples |
|---|---|---|
mdx | MDX/JSX documentation | Mintlify, Fumadocs, Docusaurus |
markdown | Plain Markdown files | READMEs, CHANGELOGs |
openapi | OpenAPI/Swagger specs | API reference docs |
How It Works
- Parse - Extract content from your docs, APIs, and READMEs
- Chunk - Split into semantic chunks optimized for search
- Embed - Generate embeddings using OpenAI or Gemini
- Store - Upload to Pinecone vector database
- Search - Query via MCP from AI assistants
Ecosystem
Add a chat UI with ContextChat
ContextMCP serves retrieval; pair it with ContextChat to give your docs a drop-in, embeddable "Ask AI" widget. ContextChat is a single Cloudflare Worker that queries your ContextMCP /search endpoint and streams answers with inline citations — add it to any site or docs page with one <script> tag.
Repository Structure
contextmcp/
├── packages/
│ ├── cli/ # npx contextmcp (npm package)
│ ├── template/ # Project template (scaffolded to users)
│ └── website/ # contextmcp.ai documentation site
└── deployments/
└── dodopayments/ # Dodo Payments specific deployment
Packages
| Package | Description | Published |
|---|---|---|
packages/cli | CLI scaffolding tool | ✅ npm: contextmcp |
packages/template | Project template | (copied by CLI) |
packages/website | Documentation site | (deployed to Vercel) |
Development
Prerequisites
- Node.js 18+
Setup
# Install all dependencies
npm install
# Development
npm run dev:website # Run website locally
npm run dev:cli # Watch CLI for changes
# Build
npm run build:website # Build website
npm run build:cli # Build CLI
# Type checking
npm run typecheck # Check all packages
Documentation
Visit contextmcp.ai/docs for full documentation.
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to contribute to this project.
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Reviews
No reviews yet. Be the first.
Related
Open Webui
Open WebUI
Github Mcp Server
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Context7
Up-to-date code docs for any prompt
mh install mcps/contextmcp