mcp-skills-server

Serves a directory of Agent Skills (SKILL.md) over MCP, per SEP-2640 "Skills Extension" — skills/list, skills/get, and skill:// resources with real SHA-256 digests.

My example is my own project, FAF. Point this at yours instead — it works on any skill.

One skill, served

Point this at a directory and here's what a client gets back for a single skill (skills/get, real output):

{
  "uri": "skill://faf-context/SKILL.md",
  "frontmatter": {
    "name": "faf-context",
    "description": "Get your project to 100% AI-readiness, fast...",
    "license": "MIT"
  },
  "resources": [
    {
      "uri": "skill://faf-context/SKILL.md",
      "digest": "sha256:5e68e7d871e02bf3f4e040ff6f904d447f52c818aa2325ccbc741fe3680dc1af",
      "size": 5513
    }
  ]
}

That digest is the real SHA-256 of the file. Run shasum -a 256 on it yourself — it matches.

faf-context is one skill from FAF. Six more come with it. Swap them for yours:

MCP_SKILLS_SERVER_ROOT=/path/to/your/skills npx mcp-skills-server

Each immediate subdirectory of the root is a skill: a SKILL.md with name and description frontmatter, name matching the directory name. That's the whole requirement.

Related MCP server: MCP Skills Server

What it implements

• skills/list — enumerates every skill this server serves: URI, verbatim frontmatter, and a complete, digest-pinned manifest of its files.

• skills/get — retrieves one skill's entry by its SKILL.md URI (including skills absent from any listing).

• resources/read — reads any file within a skill, the standard MCP way.

• resources/list — every skill file as a plain resource too, for clients that aren't skills-extension-aware.

Not yet implemented: resources/directory/read, nested skills. None of the seven bundled skills have subdirectories, so neither has been exercised yet.

Status

Early. Working, spec-conformant, not yet published. CHANGELOG.md starts once there's a release.

License

MIT