tesseract-ripple/context7

Context7 - Library Documentation

Fetch up-to-date documentation for any library with intelligent chunking and reranking.

Workflow

Step 1: Resolve Library ID

First, resolve the library name to a Context7-compatible ID:

mcp__context7__resolve-library-id({ libraryName: "<package name>" })

Example: libraryName: "react" → returns /facebook/react

Step 2: Get Documentation

Fetch docs with topic focus and token budget:

mcp__context7__get-library-docs({
  context7CompatibleLibraryID: "<library_id>",
  topic: "<specific topic>",
  tokens: 5000
})

Step 3: Rerank Results

After receiving documentation, apply this mental reranking:

1. Score by relevance - Prioritize chunks containing query terms
2. Consider recency - Newer API patterns over deprecated ones
3. Focus on examples - Code snippets > prose descriptions
4. Limit to top 5 - Present only the 5 most relevant chunks

Quick Reference

| Library Type | Example Query | Topic | |-------------|---------------|-------| | React/Vue/Angular | "React hooks for state" | "hooks" or "useState" | | FastAPI/Flask/Django | "FastAPI authentication" | "auth" or "security" | | Pandas/NumPy | "pandas merge dataframes" | "merge" or "join" | | SQLAlchemy/Prisma | "SQLAlchemy relationships" | "relationships" | | Testing libs | "pytest fixtures" | "fixtures" |

Token Budget Guidelines

• Quick lookup: 2000-3000 tokens
• Deep dive: 5000-8000 tokens
• Comprehensive: 10000+ tokens

Reranking Script

For programmatic reranking, use the wrapper script:

# Process context7 output and rerank
python ~/.config/context7/context7_wrapper.py process \
  --query "authentication middleware" \
  --top 5 \
  --input docs.md

Error Handling

If library not found:

1. Try alternative names (e.g., "nextjs" vs "next.js")
2. Check for organization prefix (e.g., "/vercel/next.js")
3. Search for related libraries

Examples

React Hooks

1. resolve-library-id({ libraryName: "react" })
2. get-library-docs({
     context7CompatibleLibraryID: "/facebook/react",
     topic: "hooks",
     tokens: 5000
   })

FastAPI Auth

1. resolve-library-id({ libraryName: "fastapi" })
2. get-library-docs({
     context7CompatibleLibraryID: "/tiangolo/fastapi",
     topic: "security oauth2",
     tokens: 5000
   })