@upstash/context7-mcp/dist/lib/constants.js

MCP server for Context7

import { readFileSync } from "fs";
import { fileURLToPath } from "url";
import { dirname, join } from "path";
const __dirname = dirname(fileURLToPath(import.meta.url));
const pkg = JSON.parse(readFileSync(join(__dirname, "../../package.json"), "utf-8"));
export const SERVER_VERSION = pkg.version;
const CONTEXT7_BASE_URL = "https://context7.com";
const MCP_RESOURCE_URL = "https://mcp.context7.com";
const DEFAULT_OAUTH_AUTH_SERVER_URL = "https://clerk.context7.com";
export const CONTEXT7_API_BASE_URL = process.env.CONTEXT7_API_URL || `${CONTEXT7_BASE_URL}/api`;
export const RESOURCE_URL = process.env.RESOURCE_URL || MCP_RESOURCE_URL;
// Clerk owns the interactive OAuth flow and is the issuer returned in the
// authorization response. Advertising Clerk directly keeps RFC 8414 discovery
// and RFC 9207 response-issuer validation on the same authorization-server
// identity.
export const OAUTH_AUTH_SERVER_URL = (process.env.OAUTH_AUTH_SERVER_URL || DEFAULT_OAUTH_AUTH_SERVER_URL).replace(/\/+$/, "");
export const OAUTH_JWKS_URL = process.env.OAUTH_JWKS_URL || `${OAUTH_AUTH_SERVER_URL}/.well-known/jwks.json`;
// Enterprise-Managed Auth (id-jag): access tokens minted by the Context7
// authorization server, validated against its public JWKS.
// AUTH_SERVER_URL remains a backwards-compatible alias for local EMA setups;
// it does not move interactive user OAuth. Local end-to-end OAuth environments
// must set OAUTH_AUTH_SERVER_URL separately when Clerk is not the intended issuer.
export const EMA_ISSUER = process.env.EMA_ISSUER || process.env.AUTH_SERVER_URL || CONTEXT7_BASE_URL;
export const EMA_JWKS_URL = process.env.EMA_JWKS_URL || `${CONTEXT7_API_BASE_URL}/oauth/ema-jwks`;
export const OPENAI_APPS_CHALLENGE_TOKEN = process.env.OPENAI_APPS_CHALLENGE_TOKEN;
export const SERVER_TITLE = "Context7";
// The vector icon scales to any size; the PNG is 512x512.
export const SERVER_ICONS = [
    {
        src: "https://context7.com/context7-icon-green.svg",
        mimeType: "image/svg+xml",
        sizes: ["any"],
    },
    {
        src: "https://context7.com/context7-icon-green.png",
        mimeType: "image/png",
        sizes: ["512x512"],
    },
];
/** Describe the remote server using the experimental Server Card v1 schema. */
export function mcpServerCard(resourceUrl = RESOURCE_URL) {
    return {
        $schema: "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
        name: "io.github.upstash/context7",
        title: SERVER_TITLE,
        description: "Up-to-date, version-specific documentation and code examples for software libraries.",
        version: SERVER_VERSION,
        websiteUrl: "https://context7.com",
        icons: SERVER_ICONS,
        remotes: [
            {
                type: "streamable-http",
                url: `${new URL(resourceUrl).origin}/mcp`,
                headers: [
                    {
                        name: "Authorization",
                        description: "Optional. A Context7 API key from https://context7.com/dashboard raises the rate limit.",
                        isRequired: false,
                        isSecret: true,
                        value: "Bearer {api_key}",
                        variables: {
                            api_key: {
                                description: "Context7 API key",
                                isSecret: true,
                                placeholder: "ctx7sk-...",
                            },
                        },
                    },
                ],
            },
        ],
    };
}