Back to Browse

Bip Skills MCP Server

Developer ToolsModerate6.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

Serves Agent Skills folders (SKILL.md + bundled files) to any MCP client. Bundles bip-xsl-hardening.

About

Serves Agent Skills folders (SKILL.md + bundled files) to any MCP client. Bundles bip-xsl-hardening.

Security Report

6.7
Moderate6.7Moderate Risk

This is a read-only Agent Skills server that serves SKILL.md folders and bundled text files over stdio or Streamable HTTP, with no outbound network calls or code execution in the server itself. The main concerns are optional bearer auth in HTTP mode (unauthenticated by default when MCP_AUTH_TOKEN is unset, and documented as such), and path containment that does not resolve symlinks. Permissions (local file read, HTTP listening, environment variables) match the server's stated purpose. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

6 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional. Extra skills folder(s), separated by ';' on Windows or ':' elsewhere. A skill found there overrides a bundled skill of the same name.Optional

Environment variable: SKILLS_DIR

Optional. Set to 1 to hide the bundled skills and serve only SKILLS_DIR.Optional

Environment variable: SKILLS_NO_BUNDLED

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "bip-skills-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp@1.1.0"
      ],
      "env": {
        "SKILLS_DIR": "your-skills-dir-here",
        "SKILLS_NO_BUNDLED": "your-skills-no-bundled-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub 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

Reviews

No reviews yet

Be the first to review this server!