ContextMCP

ContextMCP

ドキュメント向けのセルフホスト可能な MCP サーバーです。 さまざまなソースからドキュメントをインデックス化し、Model Context Protocol (MCP) と REST API を通じて提供します。

クイックスタート

# 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

ContextMCP とは？

ContextMCP は、AI アシスタントが Model Context Protocol (MCP) を通じて検索できる、ドキュメントのナレッジベースを作成します。

対応するコンテンツタイプ

パーサー	コンテンツタイプ	例
mdx	MDX/JSX ドキュメント	Mintlify、Fumadocs、Docusaurus
markdown	プレーンな Markdown ファイル	README、CHANGELOG
openapi	OpenAPI/Swagger 仕様	API リファレンスドキュメント

仕組み

1. 解析 - ドキュメント、API、README からコンテンツを抽出します
2. チャンク化 - 検索に最適化された意味的なチャンクに分割します
3. 埋め込み - OpenAI または Gemini を使用して埋め込みを生成します
4. 保存 - Pinecone ベクトルデータベースにアップロードします
5. 検索 - AI アシスタントから MCP 経由でクエリします

エコシステム

ContextChat でチャット UI を追加する

ContextMCP は検索機能を提供します。これに ContextChat を組み合わせると、ドキュメントにそのまま埋め込める「AI に質問」ウィジェットを追加できます。ContextChat は、ContextMCP の /search エンドポイントにクエリを送信し、インライン引用付きの回答をストリーミングする単一の Cloudflare Worker です。<script> タグを 1 つ追加するだけで、あらゆるサイトやドキュメントページに導入できます。

リポジトリ構成

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/cli	CLI スキャフォールディングツール	✅ npm: contextmcp
packages/template	プロジェクトテンプレート	（CLI によってコピー）
packages/website	ドキュメントサイト	（Vercel にデプロイ）

開発

前提条件

• Node.js 18+

セットアップ

# 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

ドキュメント

詳しいドキュメントについては、contextmcp.ai/docs をご覧ください。

コントリビューション

コントリビューションを歓迎します！このプロジェクトへの貢献方法については、CONTRIBUTING.md のガイドラインをご覧ください。

ライセンス

このプロジェクトは Apache License 2.0 のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。