diff --git a/docs/skills/mcp-details/SKILL.md b/docs/skills/mcp-details/SKILL.md new file mode 100644 index 0000000..cb8b17f --- /dev/null +++ b/docs/skills/mcp-details/SKILL.md @@ -0,0 +1,61 @@ +--- +name: mcp-details +description: "Reference hub for MCP and FastMCP source documentation links. Use when you need authoritative protocol, SDK, transport, and deployment docs without loading broad implementation guidance." +argument-hint: "What MCP topic do you need links for: protocol, server/client concepts, FastMCP patterns, transports, or tooling?" +x-personal-mcp: + id: mcp-details + version: 1.0.0 + tags: + - mcp + - model-context-protocol + - fastmcp + - references + - source-docs + capabilities: + - resource://skills/mcp-details/document + depends_on: [] +--- + +# MCP Details + +This skill is a reference index only. It is optimized for fast retrieval of upstream documentation links for MCP and FastMCP. + +## When to Use + +- You need official MCP protocol and architecture docs. +- You need MCP SDK links for Python or TypeScript. +- You need FastMCP docs and source references. +- You need ecosystem links for tooling, inspection, and client configuration. + +## How To Use This Skill + +1. Classify the request by intent: protocol, SDK usage, FastMCP, or ecosystem integration. +2. Open only the matching reference page first. +3. Load at most one additional reference page if the request spans multiple areas. +4. Return links grouped by category, with a one-line reason for each group. + +## Intent Router + +1. MCP fundamentals, protocol architecture, resources, tools, prompts, transports, security: [mcp-protocol-and-spec.md](./references/mcp-protocol-and-spec.md) +2. MCP SDK and FastMCP implementation references for Python and TypeScript: [sdk-and-fastmcp.md](./references/sdk-and-fastmcp.md) +3. MCP client integration and operational tooling references: [ecosystem-and-tooling.md](./references/ecosystem-and-tooling.md) + +## Load Order + +1. Start with the single best-match reference page from the Intent Router. +2. If the question includes both protocol and implementation details, load [mcp-protocol-and-spec.md](./references/mcp-protocol-and-spec.md) then [sdk-and-fastmcp.md](./references/sdk-and-fastmcp.md). +3. Load [ecosystem-and-tooling.md](./references/ecosystem-and-tooling.md) only when the request includes client setup, inspector usage, or deployment/operations context. + +## Load Budget + +1. Single-focus request: 1 reference page. +2. Mixed protocol and implementation request: 2 reference pages. +3. Broad audit or migration planning request: up to 3 reference pages. + +## Output Contract + +When this skill is applied, return: +1. Which reference files were consulted. +2. The discovery path used (intent classification and load order). +3. Curated source-document links grouped by topic. +4. Any notable gaps or ambiguities in the currently indexed links. diff --git a/docs/skills/mcp-details/references/ecosystem-and-tooling.md b/docs/skills/mcp-details/references/ecosystem-and-tooling.md new file mode 100644 index 0000000..142ab87 --- /dev/null +++ b/docs/skills/mcp-details/references/ecosystem-and-tooling.md @@ -0,0 +1,29 @@ +# Ecosystem and Tooling + +Use this page for MCP client setup, operational tools, and integration references. + +## VS Code and Copilot MCP Integration + +!!! info "VS Code MCP docs" + - [VS Code MCP servers overview](https://code.visualstudio.com/docs/agent-customization/mcp-servers) + - [VS Code MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration) + - [VS Code Copilot customization overview](https://code.visualstudio.com/docs/copilot/customization/overview) + +## Debugging and Inspection + +!!! info "Inspector and diagnostics" + - [MCP inspector repository](https://github.com/modelcontextprotocol/inspector) + - [MCP protocol repository issues](https://github.com/modelcontextprotocol/spec/issues) + - [Python logging configuration docs](https://docs.python.org/3/library/logging.config.html) + +## Runtime and API Framework References + +!!! info "Runtime references" + - [FastAPI documentation](https://fastapi.tiangolo.com/) + - [Uvicorn settings](https://www.uvicorn.org/settings/) + - [AnyIO documentation](https://anyio.readthedocs.io/en/stable/) + +## Notes + +- Use these links when tasks include IDE wiring, MCP server runtime setup, or production operations. +- Keep protocol and SDK references separate to avoid overloading implementation prompts. diff --git a/docs/skills/mcp-details/references/mcp-protocol-and-spec.md b/docs/skills/mcp-details/references/mcp-protocol-and-spec.md new file mode 100644 index 0000000..817438f --- /dev/null +++ b/docs/skills/mcp-details/references/mcp-protocol-and-spec.md @@ -0,0 +1,32 @@ +# MCP Protocol and Specification + +Use this page for authoritative links about MCP concepts, protocol shape, and official specification assets. + +## Official Documentation + +!!! info "MCP docs" + - [MCP introduction](https://modelcontextprotocol.io/docs/getting-started/intro) + - [Architecture overview](https://modelcontextprotocol.io/docs/learn/architecture) + - [Server concepts](https://modelcontextprotocol.io/docs/learn/server-concepts) + - [Client concepts](https://modelcontextprotocol.io/docs/learn/client-concepts) + - [Security overview](https://modelcontextprotocol.io/docs/learn/security-overview) + +## Protocol and Schema Sources + +!!! info "Specification repositories" + - [MCP specification repository](https://github.com/modelcontextprotocol/spec) + - [Specification schema directory](https://github.com/modelcontextprotocol/spec/tree/main/schema) + - [Specification issues and proposals](https://github.com/modelcontextprotocol/spec/issues) + +## Core Capability References + +!!! info "Capability details" + - [Resources concept docs](https://modelcontextprotocol.io/docs/learn/server-concepts#resources) + - [Tools concept docs](https://modelcontextprotocol.io/docs/learn/server-concepts#tools) + - [Prompt objects concept docs](https://modelcontextprotocol.io/docs/learn/server-concepts#prompts) + - [Sampling concept docs](https://modelcontextprotocol.io/docs/learn/client-concepts) + +## Notes + +- Prefer these links when the user asks about protocol correctness, transport semantics, capability naming, or compatibility. +- For implementation-level examples, use [sdk-and-fastmcp.md](./sdk-and-fastmcp.md). diff --git a/docs/skills/mcp-details/references/sdk-and-fastmcp.md b/docs/skills/mcp-details/references/sdk-and-fastmcp.md new file mode 100644 index 0000000..1b7ed82 --- /dev/null +++ b/docs/skills/mcp-details/references/sdk-and-fastmcp.md @@ -0,0 +1,31 @@ +# SDK and FastMCP + +Use this page for implementation-oriented links across MCP SDKs and FastMCP. + +## MCP SDKs + +!!! info "SDK sources" + - [Python SDK repository](https://github.com/modelcontextprotocol/python-sdk) + - [TypeScript SDK repository](https://github.com/modelcontextprotocol/typescript-sdk) + - [Python SDK documentation](https://modelcontextprotocol.github.io/python-sdk/) + +## FastMCP + +!!! info "FastMCP sources" + - [FastMCP project documentation](https://gofastmcp.com/) + - [FastMCP GitHub repository](https://github.com/jlowin/fastmcp) + - [FastMCP examples directory](https://github.com/jlowin/fastmcp/tree/main/examples) + - [FastMCP PyPI package](https://pypi.org/project/fastmcp/) + +## Server Implementation Patterns + +!!! info "Implementation references" + - [MCP server concepts](https://modelcontextprotocol.io/docs/learn/server-concepts) + - [MCP architecture patterns](https://modelcontextprotocol.io/docs/learn/architecture) + - [Python packaging and resources](https://docs.python.org/3/library/importlib.resources.html) + +## Notes + +- Prefer official SDK repositories for API shape and compatibility checks. +- Use FastMCP references for rapid server scaffolding and implementation examples. +- For protocol-first questions, start from [mcp-protocol-and-spec.md](./mcp-protocol-and-spec.md).