使用说明（Markdown 格式）

项目简介

JAGENTS MCP 服务器集合是一组基于 Model Context Protocol (MCP) 的后端服务，专门向 MCP 客户端提供可执行的“工具集”（Tools/Resources）、以及通过 JSON-RPC 进行交互的能力注册与调用。核心实现包含四类 MCP 服务器：Agents、Skills、Workflows、Rules，每类服务器都暴露标准的 MCP 接口，用以列出可用工具、接收工具调用并返回结果。服务器使用标准的 StdioTransport 作为传输层，便于在本地进程间通过标准输入/输出进行通信，也可与其他传输方式配合使用。

主要功能点

模块化服务器架构：4 个独立的 MCP 服务器（Agents、Skills、Workflows、Rules），各自管理自己的工具集合。
MCP 协议实现：实现 ListToolsRequestSchema 与 CallToolRequestSchema 的请求处理，响应符合 MCP JSON-RPC 规范，返回 content 结构中的文本内容。
工具/技能注册与执行：每个工具/技能/工作流/规则都以 toolDefinition 描述名称、描述与输入模式，并实现 execute(...) 来执行对应逻辑。
本地传输支持：采用 StdioServerTransport，易于在本地开发与测试环境中通过标准输入/输出进行 MCP 客户端通信。
安全性与扩展性设计：具备多组独立服务器、清晰的输入输出定义、以及可扩展的技能/工作流/规则集合，便于进一步扩展与集成。

安装与运行

依赖与环境要求
- Node.js 18+（项目基于 TypeScript/Node 环境实现，构建输出通常为 dist/index.js）。
构建与运行步骤（示例）
1. 克隆仓库并进入目录
  - 进入 jagents/jagents-mcp-servers 目录下，分别对四个服务器执行构建与运行。
2. 构建
  - 项目提供的构建脚本/build-all.sh，推荐执行以生成 dist/index.js。
  - 也可逐一在各服务器目录执行 npm install && npm run build（若有对应的 package.json 配置）。
3. 运行服务器
  - 逐个启动四个 MCP 服务器（示例路径为 dist/index.js）：
    - node jagents-mcp-servers/agents-mcp-server/dist/index.js
    - node jagents-mcp-servers/skills-mcp-server/dist/index.js
    - node jagents-mcp-servers/workflows-mcp-server/dist/index.js
    - node jagents-mcp-servers/rules-mcp-server/dist/index.js
  - 也可结合容器/进程管理工具进行并行启动与监控。
4. MCP 客户端对接（配置示例，非代码块描述）
  - MCP 客户端需要知道服务器的启动命令与参数来建立连接，常见做法是为每个服务器提供一个配置项，包含 server_name、command、args 等信息，便于 MCP 客户端按需启动并与 MCP 服务器建立 JSON-RPC 通道。
服务器配置（MCP 客户端使用，用于描述启动方式）说明：以下为示例描述，实际启动请根据具体部署路径填写。该配置用于 MCP 客户端在本地或远端启动对应的 MCP 服务器进程以建立连接。
- Agents MCP 服务器配置（示例） { "server_name": "jagents-agents-server", "command": "node", "args": ["/path/to/jagents/jagents-mcp-servers/agents-mcp-server/dist/index.js"] }
- Skills MCP 服务器配置（示例） { "server_name": "jagents-skills-server", "command": "node", "args": ["/path/to/jagents/jagents-mcp-servers/skills-mcp-server/dist/index.js"] }
- Workflows MCP 服务器配置（示例） { "server_name": "jagents-workflows-server", "command": "node", "args": ["/path/to/jagents/jagents-mcp-servers/workflows-mcp-server/dist/index.js"] }
- Rules MCP 服务器配置（示例） { "server_name": "jagents-rules-server", "command": "node", "args": ["/path/to/jagents/jagents-mcp-servers/rules-mcp-server/dist/index.js"] } 注释说明
- 以上配置仅用于 MCP 客户端调用示例，实际部署中应结合实际路径、容器化部署、环境变量、守护进程等进行调整。
基本使用方法
- 启动后，MCP 客户端可通过 JSON-RPC 请求向任一服务器查询可用工具（ListTools）并按名称调用具体工具（CallTool），服务器返回经过 MCP 规范格式化的文本内容。
- 典型工作流包括按需拉取工具列表、执行工具、接收结果与后续处理；四类服务器共同构成一个可组合、可扩展的 MCP 背景服务生态，用于提供资源、工具、Prompt 等能力。

关键词 AI协作框架, 模块化后端, 上下文服务, 自动化工作流, 安全与合规

类别 1

关键词

信息