claude-skills-vault
使用说明(Markdown 格式)
-
项目简介 claude-skills-vault 是一个包含多种 MCP 服务器实现的开源仓库。每个服务器实现了 MCP 的核心能力,用以向 LLM 客户端提供统一的资源访问、工具调用和上下文渲染能力。仓库内的实现覆盖了不同场景,如 Jira、MongoDB、Supabase 等服务的 MCP 服务端实现,便于在多种环境中搭建和测试 MCP 基础设施。
-
主要功能点
- 资源管理与数据访问:通过 MCP 服务器暴露对资源/数据的只读或指定操作能力。
- 工具注册与执行:LLM 客户端可以在运行时查询可用工具并调用工具,获取结构化输出。
- JSON-RPC 通信范式:服务器以 MCP 的标准格式读写请求与响应,便于与 LLM 客户端对接。
- 多传输协议支持:包含 stdio、Server-Sent Events(SSE)、WebSocket/HTTP 等可能实现(具体实现以各服务为准)。
- 会话与能力声明:提供会话管理、能力声明以及对外暴露的工具、资源等能力集合。
-
安装与运行步骤(通用)
- 为每个 MCP 服务器的实现,先将源码构建成可执行形式(通常需要安装 Node.js/TypeScript 构建工具,执行构建命令生成 dist/index.js 等可执行文件)。
- 启动服务器:使用构建产物按服务器的启动方式运行,例如 node dist/index.js。
- 确保运行时所需的外部依赖已配置好(如数据库地址、外部 API 令牌等环境变量)。
- MCP 客户端连接配置:客户端在连接时需要提供服务器启动命令及参数(详见下方配置示例)。
-
服务器配置(MCP 客户端需要的配置信息,JSON 格式,示例说明) 说明:以下配置用于 MCP 客户端连接到各 MCP 服务器时使用。每条记录包含服务器名称、启动命令和参数等信息。请在实际环境中将 command/args 替换为真实的部署执行命令和参数。
{ "servers": [ { "name": "jira-bridge", "command": "node", "args": ["dist/index.js"], // 运行打包后的 MCP 服务器入口 "notes": "Jira MCP 服务端实现,需先执行构建,将 TS 转换为 JS。" }, { "name": "mongodb-mcp", "command": "node", "args": ["dist/index.js"], "notes": "MongoDB MCP 服务端实现,连接本地/远程 Mongo 数据库。" }, { "name": "supabase-mcp", "command": "node", "args": ["dist/index.js"], "notes": "Supabase MCP 服务端实现,供客户端执行数据库、认证、存储等操作。" } ] }
-
基本使用方法
- 在服务器启动后,使用 MCP 客户端按标准的 JSON-RPC 调用向服务器发起请求,进行资源读取、工具调用和提示渲染等操作。
- 若要扩展或自定义,请参考各服务器实现中的 API 定义(工具列表、资源/读取接口等)。
- 如需本地调试,可在一个开发环境中同时运行多个 MCP 服务端,并通过客户端逐一连接测试。
-
备注
- 仓库包含多种 MCP 服务端实现,覆盖不同系统与数据库/云服务的集成场景,适合在研究、开发、以及原型验证阶段使用。
- 部署时请确保各服务的依赖与凭证安全配置妥当,特别是外部 API keys、数据库连接串与权限控制等。
关键词: 模型上下文协议, 工具调用, 资源访问, JSON-RPC, LLM 集成 分类ID: 6