Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dodopayments--context-mcp/badge.svg)](/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

i

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)

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

Free to use. If it’s helped, pass it on.