mcpField
B
BIP Skills MCP

BIP Skills MCP

Local
github.com/2fizzleAI & Agents0Updated 2d ago
Repository

About BIP Skills MCP

BIP Skills MCP is an MCP server for exposing Agent Skills folders to MCP clients. It includes the bip-xsl-hardening skill and can serve additional local folders without uploading them.

Key features

  1. 01List and filter available skills
  2. 02Read skill instructions and files
  3. 03Expose skills as MCP resources
  4. 04Serve bundled and local skill folders
  5. 05Support stdio and Streamable HTTP

Use cases

  1. 01Browse skills available to an agent
  2. 02Retrieve a skill's instructions and supporting files
  3. 03Serve private local skills to an MCP client

MCP support

The server exposes skill discovery and read-only file tools, as well as each skill as an MCP resource. It supports stdio and Streamable HTTP connections.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "2fizzle-bip-skills": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ],
      "env": {
        "SKILLS_DIR": "<SKILLS_DIR>",
        "SKILLS_NO_BUNDLED": "<SKILLS_NO_BUNDLED>"
      }
    }
  }
}
Run commandnpx -y @2fizzle/bip-skills-mcp
Environment variables to set
SKILLS_DIROptional. Extra skills folder(s), separated by ';' on Windows or ':' elsewhere. A skill found there overrides a bundled skill of the same name.
SKILLS_NO_BUNDLEDOptional. Set to 1 to hide the bundled skills and serve only SKILLS_DIR.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@2fizzle/bip-skills-mcp1.0.1

Tools

4

Saved tool list · updated 2d ago

ParameterTypeRequiredDescription
querystringNoOptional text to filter skills by name or description, e.g. 'xsl' or 'oracle'

Details

From the project README

bip-skills-mcp

MCP server that serves Agent Skills — folders containing a SKILL.md plus optional references/, scripts/, assets/ — to any MCP client (Claude Desktop, Claude Code, Cursor, VS Code…).

It ships with one skill, bip-xsl-hardening (XSLT 1.0 patterns for Oracle BI Publisher HTML dashboards: locale-independent grouping, multi-shape XML, adaptive fallback, date arithmetic without EXSLT). Point SKILLS_DIR at your own folders to serve your private skills from your machine — they are never uploaded anywhere.

Tools

ToolPurpose
skills_listList skills (name, description, source). Optional query filter.
skills_getFull SKILL.md of a skill.
skills_list_filesBundled files of a skill with sizes.
skills_read_fileRead one text file of a skill (path-traversal protected, 2 MB max).

Each skill is also exposed as a resource: skill://<name>/SKILL.md. All tools are read-only.

Install

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "@2fizzle/bip-skills-mcp"],
      "env": { "SKILLS_DIR": "C:\\path\\to\\my\\skills" }
    }
  }
}
VariableEffect
SKILLS_DIRExtra skill folders, ;-separated on Windows, : elsewhere. Searched up to 3 levels deep. A local skill overrides a bundled one with the same name.
SKILLS_NO_BUNDLED=1Serve only SKILLS_DIR.

Requires Node.js 20.3+.

Remote use (Streamable HTTP)

Set TRANSPORT=http to serve MCP over HTTP at /mcp (health check at /health).

VariableDefaultEffect
TRANSPORTstdiohttp turns on the HTTP server.
PORT3000Listening port.
HOST127.0.0.1, or 0.0.0.0 when PORT is set by the hostBind address.
ALLOWED_HOSTS—Comma-separated public host names accepted in the Host header when binding 0.0.0.0 (DNS-rebinding protection).
MCP_AUTH_TOKEN—If set, every /mcp request must send Authorization: Bearer <token>. Leave unset only if the served skills are public.

Run locally:

TRANSPORT=http npx -y @2fizzle/bip-skills-mcp
# → http://127.0.0.1:3000/mcp
Deploy
  • Render: New → Blueprint → this repository (uses render.yaml). Set MCP_AUTH_TOKEN in the dashboard if you want a token, and change ALLOWED_HOSTS to your service host name.
  • Any Docker host (Fly.io, Railway, Cloud Run…): docker build -t bip-skills-mcp . then run with -p 3000:3000 -e ALLOWED_HOSTS=your.host.

A hosted instance only serves the bundled skills: SKILLS_DIR points to a local folder and has no effect there.

Connect
  • Claude (web, desktop, mobile): Settings → Connectors → Add custom connector → https://<your-host>/mcp. Custom connectors support no-auth or OAuth servers, not static bearer tokens — leave MCP_AUTH_TOKEN unset for this route.
  • Claude Code: claude mcp add --transport http bip-skills https://<your-host>/mcp --header "Authorization: Bearer <token>"

Develop

npm install
npm run build
npm run smoke        # stdio: starts the server and checks every tool
npm run smoke:http   # HTTP: checks /health, bearer auth and every tool

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.