BIP Skills MCP

io.github.2fizzle由 GitHub 账号 2fizzle 发布v1.0.1更新于 Nov 8, 2026

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

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

本地 MCP 服务器，向任意 MCP 客户端提供 Agent Skills 文件夹（SKILL.md 及附带文件），并内置一个 XSLT 加固技能。

可以做什么
  • 列出可用技能的名称、描述与来源，可按查询词过滤
  • 读取技能的完整 SKILL.md，并列出其附带文件及大小
  • 读取技能内的单个文本文件，带路径穿越防护和 2 MB 上限
  • 将每个技能以 skill:// /SKILL.md 资源形式暴露
  • 在自带技能之外或替代自带技能，提供本机自定义技能文件夹
适用场景
当你把可复用的 Agent Skills 以文件夹形式保存在本机，并希望助手按需发现和读取它们时适用；也适合在 Claude Desktop、Claude Code、Cursor 或 VS Code 中使用内置的 Oracle BI Publisher HTML 仪表板 XSLT 1.0 模式。
运行要求
需要 Node.js 20.3 或更高版本，通过 npx 以 stdio 在本地运行。可选 SKILLS_DIR 指向额外技能文件夹（Windows 用 ; 分隔，其他平台用 :，最多向下搜索 3 层）；SKILLS_NO_BUNDLED=1 时只提供这些文件夹。可选 HTTP 模式使用 TRANSPORT=http 及 PORT、HOST、ALLOWED_HOSTS、MCP_AUTH_TOKEN。
安装前请注意
所有工具均为只读，但 skills_read_file 会把所配置技能文件夹中的文本文件暴露给已连接的助手，因此 SKILLS_DIR 只应指向你愿意共享的文件夹。若启用 HTTP 模式并绑定到本机以外，请设置 MCP_AUTH_TOKEN 和 ALLOWED_HOSTS；不设令牌仅适用于公开技能。托管实例只提供内置技能。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BIP Skills MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

json
{  "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:

bash
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

bash
npm installnpm run buildnpm run smoke        # stdio: starts the server and checks every toolnpm run smoke:http   # HTTP: checks /health, bearer auth and every tool

License

MIT

来源：README.md，提交 6866b3b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Nov 8, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分