Context7 MCP

🚀 Context7 Project

Context7 is a powerful MCP (Machine Learning Model Service) platform for AI coding assistants. It significantly enhances development efficiency by providing detailed documentation and library ID resolution capabilities. This project is community-contributed and has received extensive support.

🚀 Quick Start

📦 Installation

Using npx

npx -y @upstash/context7-mcp@latest

Configuration Example

Add the following content to your MCP configuration file:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

💻 Usage Examples

Available Tools

Tool List

1. resolve-library-id: Convert a generic library name to a Context7-compatible library ID.
   • libraryName (Required)
2. get-library-docs: Retrieve documentation using a Context7-compatible library ID.
   • context7CompatibleLibraryID (Required)
   • topic (Optional): Focus on a specific topic (e.g., "routing", "hooks").
   • tokens (Optional, default 5000): Maximum number of tokens to return. Values below the configured DEFAULT_MINIMUM_TOKENS will be automatically increased to that value.

Environment Variable Configuration

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "env": {
        "DEFAULT_MINIMUM_TOKENS": "10000"
      }
    }
  }
}

🔧 Technical Details

Development Information

Clone the Project and Install Dependencies

bun i

Build the Project

bun run build

Local Configuration Example

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}

Testing with MCP Inspector

Run the following command:

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest

🐞 Troubleshooting

Module Not Found Error (ERR_MODULE_NOT_FOUND)

If you encounter this error, try using bunx instead of npx:

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

ESM Resolution Issue

If you encounter an error like Error: Cannot find module 'uriTemplate.js', try adding the experimental VM module flag:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "--node-options=--experimental-vm-modules",
        "@upstash/context7-mcp@1.0.6"
      ]
    }
  }
}

MCP Client Error

1. Try removing @latest from the package name.
2. Try using bunx as an alternative.
3. Try using deno as an alternative.
4. Ensure you are using a Node.js version that supports the required features.

📄 License

Context7 is a community-driven project aimed at providing enhanced functionality for AI coding assistants. While every effort has been made to ensure the accuracy of the content, there is no guarantee that it will be suitable for all scenarios. It is recommended to conduct thorough testing before using it in a production environment.

With the above configuration and tools, you can fully leverage Context7 to enhance development efficiency and enjoy powerful documentation retrieval and library resolution capabilities.