MCP Ecosystem — Sourcey

Sourcey's MCP support is built on two standalone npm packages published under the sourcey org. They're useful independently of sourcey for any project that works with MCP server specifications.

mcp-schema

TypeScript types and JSON Schema for the mcp.json snapshot format.

npm install mcp-schema

import type { McpSpec, McpTool, McpResource } from "mcp-schema";
import { mcpSpecSchema } from "mcp-schema/schema";

Provides typed interfaces for the full MCP surface: tools (with inputSchema, outputSchema, annotations), resources, resource templates, prompts, server capabilities, and transport configuration. The JSON Schema can be used with any validator (Ajv, Zod, etc.).

Zero runtime dependencies.

GitHub
npm

mcp-parser

Parse, validate, snapshot, and generate from MCP server specifications.

npm install mcp-parser

import { parse, validate, snapshot, generateLlmsTxt } from "mcp-parser";

const spec = await parse("./mcp.json");
const result = validate(spec);
const llmsTxt = generateLlmsTxt(spec);

API

Function	Description
`parse(path)`	Parse an `mcp.json` file with `$ref` dereferencing
`parseString(json)`	Parse from a JSON string
`validate(spec)`	Check for errors and best-practice warnings
`snapshot(options)`	Connect to a running server and capture a snapshot
`generateLlmsTxt(spec)`	Generate an llms.txt index
`generateLlmsFullTxt(spec)`	Generate a complete markdown reference

CLI

mcp-parser parse ./mcp.json
mcp-parser validate ./mcp.json
mcp-parser snapshot --stdio "node server.js" -o mcp.json
mcp-parser snapshot --sse http://localhost:3000/sse -o mcp.json
mcp-parser snapshot --http http://localhost:3000/mcp -o mcp.json
mcp-parser generate ./mcp.json --format llms-txt -o llms.txt

Depends on mcp-schema for types.

GitHub
npm

How they fit into sourcey

Sourcey depends on mcp-parser (which brings mcp-schema transitively). When you add an mcp tab to your config, sourcey uses mcp-parser to parse the mcp.json file and then normalizes it into the same internal format used for OpenAPI specs. The rendering pipeline, search, navigation, and theming work identically.

You don't need to install mcp-parser or mcp-schema separately to use MCP tabs in sourcey. They're included as dependencies.

Supported MCP protocol versions

Both packages support all released versions of the MCP specification:

Protocol Version	Status
`2025-11-25`	Current stable
`2025-06-18`	Supported
`2025-03-26`	Supported
`2024-11-05`	Supported

MCP specification resources

MCP Specification (current stable)
Specification repo
TypeScript SDK (@modelcontextprotocol/sdk)
Python SDK (mcp on PyPI)