context-mcp
Self-hosted MCP server for your documentation
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dodopayments/context-mcp with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dodopayments/context-mcp'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/dodopayments--context-mcp)HTML
<a href="/listings/dodopayments--context-mcp"><img src="/api/listings/dodopayments--context-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# 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 was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 122 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # ContextMCP
- <p align="left">
- <a href="https://discord.gg/bYqAp4ayYh">
- <img src="https://img.shields.io/discord/1305511580854779984?label=Join%20Discord&logo=discord" alt="Join Discord" />
- </a>
- <a href="https://twitter.com/dodopayments">
- <img src="https://img.shields.io/twitter/follow/dodopayments?label=Follow&style=social" alt="Twitter Follow" />
- </a>
- </p>
- **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.
- ## Quick Start
- ```bash
- # 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)](https://modelcontextprotocol.io/).
- ### 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
- 1. **Parse** - Extract content from your docs, APIs, and READMEs
- 2. **Chunk** - Split into semantic chunks optimized for search
- 3. **Embed** - Generate embeddings using OpenAI or Gemini
- 4. **Store** - Upload to Pinecone vector database
- 5. **Search** - Query via MCP from AI assistants
- ## Ecosystem
- ### Add a chat UI with ContextChat
- ContextMCP serves retrieval; pair it with [**ContextChat**](https://github.com/dodopayments/context-chat) 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
- ```bash
- # 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](https://contextmcp.ai/docs) for full documentation.
- ## Contributing
- We welcome contributions! Please see [CONTRIBUTING.md](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](LICENSE) file for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.