# BIP Skills MCP

> BIP Skills MCP is an open-source MCP server for developer tools. Serve Agent Skills folders to any MCP client, with an XSLT hardening skill bundled. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/2fizzle/bip-skills-mcp
- **MCP Registry name:** io.github.2fizzle/bip-skills-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

A skill here is a folder with a SKILL.md and optional references, scripts and assets. This server makes those folders readable by MCP clients such as Claude Desktop, Claude Code, Cursor and VS Code, and exposes each one as a resource at skill://name/SKILL.md. Point SKILLS_DIR at your own folders and they are served from your machine; the README says they are never uploaded.

One skill ships inside: bip-xsl-hardening, covering XSLT 1.0 patterns for Oracle BI Publisher HTML dashboards, such as locale-independent grouping, multi-shape XML, adaptive fallback and date arithmetic without EXSLT. A local skill with the same name overrides a bundled one, and SKILLS_NO_BUNDLED=1 serves only your folders.

It defaults to stdio and needs Node.js 20.3 or newer. Setting TRANSPORT=http serves MCP at /mcp with a health check, an optional bearer token and DNS-rebinding host checks, with Render and Docker deployment notes. A hosted instance serves only the bundled skills.

## Features

- **Skill folders over MCP:** Serves SKILL.md plus bundled files from any directory you point it at.
- **Four read-only tools:** List, fetch, list files and read one file of a skill.
- **Skill resources:** Each skill is also exposed as a skill:// resource.
- **Local override:** A skill in SKILLS_DIR replaces a bundled skill of the same name.
- **HTTP transport:** Optional streamable HTTP with bearer-token auth and allowed hosts.
- **Safe file reads:** Path traversal is blocked and files are capped at 2 MB.

## Good for

- Share a private skill library with several MCP clients
- Give an agent XSLT 1.0 patterns for Oracle BI Publisher dashboards
- Host a read-only skills endpoint on Render or any Docker host
- Search a skills collection by keyword from a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add bip-skills-mcp -- npx -y @2fizzle/bip-skills-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bip-skills-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bip-skills-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bip-skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bip-skills-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bip-skills-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ]
    }
  }
}
```

## Tools

- `skills_list`: Lists skills with name, description and source, with an optional query filter.
- `skills_get`: Returns the full SKILL.md of a skill.
- `skills_list_files`: Lists the bundled files of a skill with sizes.
- `skills_read_file`: Reads one text file of a skill, with path-traversal protection and a 2 MB limit.

## FAQ

### Are my private skills uploaded anywhere?

The README says skills in SKILLS_DIR are served from your machine and never uploaded.

### What does the bundled skill cover?

bip-xsl-hardening: XSLT 1.0 patterns for Oracle BI Publisher HTML dashboards.

### Which Node version is needed?

Node.js 20.3 or newer.

### Can I run it remotely?

Yes, set TRANSPORT=http; a hosted copy serves only the bundled skills because SKILLS_DIR points to a local folder.

### Can claude.ai connect with a bearer token?

No. The README says custom connectors support no-auth or OAuth, so leave MCP_AUTH_TOKEN unset for that route.

### Is BIP Skills MCP free?

Yes. BIP Skills MCP is open source, so you can use and self-host it for free.

### How do I add BIP Skills MCP to Claude Code?

Run this command in your terminal: claude mcp add bip-skills-mcp -- npx -y @2fizzle/bip-skills-mcp

### What are the best alternatives to BIP Skills MCP?

The closest alternatives to BIP Skills MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/bip-skills-mcp
