BIP Skills MCP

Name: BIP Skills MCP
Author: 2fizzle

本地服务

github.com/2fizzleAI 与智能体02 天前更新

代码仓库

关于 BIP Skills MCP

BIP Skills MCP 是向 MCP 客户端提供 Agent Skills 文件夹的 MCP 服务，内置 bip-xsl-hardening，也可从本地文件夹提供技能，且不会上传这些文件。

主要功能

01列出并筛选可用技能
02读取技能说明和文件
03将技能作为 MCP 资源提供
04提供内置及本地技能文件夹
05支持 stdio 和 Streamable HTTP

适用场景

01浏览 Agent 可用的技能
02获取技能说明及其配套文件
03向 MCP 客户端提供本地私有技能

MCP 相关

该服务提供技能发现和只读文件工具，并将每项技能作为 MCP 资源提供。支持 stdio 和 Streamable HTTP 连接。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "2fizzle-bip-skills": {
      "command": "npx",
      "args": [
        "-y",
        "@2fizzle/bip-skills-mcp"
      ],
      "env": {
        "SKILLS_DIR": "<SKILLS_DIR>",
        "SKILLS_NO_BUNDLED": "<SKILLS_NO_BUNDLED>"
      }
    }
  }
}

启动命令npx -y @2fizzle/bip-skills-mcp

需要配置的环境变量

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.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

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

工具

收录的工具列表 · 更新于 2 天前

参数	类型	必填	说明
query	string	否	可选。按名称或描述筛选 skill 的文本，例如 'xsl' 或 'oracle'

详细介绍

bip-skills-mcp

MCP 服务，用于向任意 MCP 客户端（Claude Desktop、Claude Code、Cursor、VS Code…）提供Agent Skills——其中包含 SKILL.md，以及可选的 references/、scripts/、assets/ 文件夹。

项目内置一个技能：bip-xsl-hardening（用于 Oracle BI Publisher HTML 仪表板的 XSLT 1.0 模式：与区域设置无关的分组、多种 XML 形态、自适应回退、不依赖 EXSLT 的日期运算）。将 SKILLS_DIR 指向你自己的文件夹，即可从本机提供私有技能——它们绝不会上传到任何地方。

工具

工具	用途
`skills_list`	列出技能（名称、描述、来源）。可选的 `query` 筛选条件。
`skills_get`	获取某个技能的完整 `SKILL.md`。
`skills_list_files`	列出某个技能包含的文件及其大小。
`skills_read_file`	读取某个技能的一个文本文件（防止路径遍历，最大 2 MB）。

每个技能也会作为资源公开：skill://<name>/SKILL.md。所有工具均为只读。

安装

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "@2fizzle/bip-skills-mcp"],
      "env": { "SKILLS_DIR": "C:\\path\\to\\my\\skills" }
    }
  }
}

变量	作用
`SKILLS_DIR`	额外的技能文件夹；在 Windows 上以 `;` 分隔，其他系统上以 `:` 分隔。最多向下搜索 3 层。同名的本地技能会覆盖内置技能。
`SKILLS_NO_BUNDLED=1`	仅提供 `SKILLS_DIR` 中的技能。

需要 Node.js 20.3+。

远程使用（Streamable HTTP）

设置 TRANSPORT=http，即可通过 HTTP 在 /mcp 提供 MCP 服务（健康检查地址为 /health）。

变量	默认值	作用
`TRANSPORT`	`stdio`	设置为 `http` 可启用 HTTP 服务。
`PORT`	`3000`	监听端口。
`HOST`	`127.0.0.1`；当 `PORT` 由主机设置时为 `0.0.0.0`	绑定地址。
`ALLOWED_HOSTS`	—	绑定到 `0.0.0.0` 时，允许在 `Host` 标头中使用的公开主机名，以逗号分隔（防止 DNS 重绑定）。
`MCP_AUTH_TOKEN`	—	如果设置，则每个 `/mcp` 请求都必须发送 `Authorization: Bearer <token>`。仅当提供的技能是公开内容时才留空。

在本地运行：

TRANSPORT=http npx -y @2fizzle/bip-skills-mcp
# → http://127.0.0.1:3000/mcp

部署

Render：选择 New → Blueprint → 此仓库（使用 render.yaml）。如需使用令牌，请在控制面板中设置 MCP_AUTH_TOKEN，并将 ALLOWED_HOSTS 更改为你的服务主机名。
任意 Docker 主机（Fly.io、Railway、Cloud Run…）：运行 docker build -t bip-skills-mcp .，然后使用 -p 3000:3000 -e ALLOWED_HOSTS=your.host 启动。

托管实例仅提供内置技能：SKILLS_DIR 指向本地文件夹，在此处不会生效。

连接

Claude（网页、桌面、移动端）：Settings → Connectors → Add custom connector → https://<your-host>/mcp。自定义连接器支持无身份验证或 OAuth 服务，不支持静态 Bearer 令牌——使用此方式时请留空 MCP_AUTH_TOKEN。
Claude Code：claude mcp add --transport http bip-skills https://<your-host>/mcp --header "Authorization: Bearer <token>"

开发

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