AI导哈

AI代理技能服务

一个基于Model Context Protocol（MCP）的服务，用于暴露和管理AI代理的专用技能集，支持文件基础技能注册和动态工具注册。

  • by sohutv
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 sohutv/agent-skills-mcp

使用说明

代理技能MCP服务器

该项目实现了一个模型上下文协议（MCP）服务器，该服务器向AI代理公开“技能”。技能是专门的指令集和资源，帮助代理使用领域专业知识执行特定任务。您可以在此处找到详细的技能说明： 代理技能规范

概述

Agent Skills MCP Server允许您使用简单的基于文件的结构（目录或ZIP文件）定义技能，该结构包含 SKILL.md 文件。然后，此服务器将这些技能作为代理可以调用的MCP工具公开。

当代理调用技能工具时，它会收到：

  1. 说明：完成任务的专业指导。
  2. 资源：访问与技能相关的文件和数据。
  3. 元数据：有关技能的信息，如允许的工具和许可证。

特性

  • 基于文件的技能注册表：技能从本地目录加载。
  • 支持目录和ZIP技能：技能可以定义为目录或打包为 .zip 或 .skill 文件。
  • 动态工具注册：每个技能都会自动注册为MCP工具。
  • 资源访问：技能资源通过MCP资源URI公开。
  • Spring Boot集成：使用Spring Boot和Spring AI构建。

入门指南

先决条件

  • Java 24
  • 梅文

配置

服务器在指定的目录中查找技能 skills.root 财产。默认情况下，它会查找 skills 当前工作目录中的目录。

您可以在中进行配置 application.properties 或通过命令行参数：

skills.root=/path/to/your/skills

建设项目

mvn clean package

运行服务器

java -jar target/agent-skills-mcp.jar

或者使用自定义技能目录：

java -jar target/agent-skills-mcp.jar --skills.root=/path/to/my/skills

创造技能

技能是由 SKILL.md 文件。此文件包含用于元数据的YAML前端内容和用于说明的Markdown内容。

结构

技能可以是目录或ZIP文件。

目录结构：

my-skill/
├── SKILL.md
├── data.csv
└── script.py

SKILL.md格式：

---
name: My Skill Name
description: A short description of what this skill does.
license: MIT
allowed_tools:
  - tool_name_1
  - tool_name_2
extra:
  key: value
---

# Instructions

Here are the detailed instructions for the agent...

元数据字段

  • name：（必填）技能的显示名称。
  • description：（必填）用于工具定义的简要说明。
  • license：（可选）技能的许可证信息。
  • allowed_tools：（可选）代理在执行此技能时允许/鼓励使用的工具名称列表。
  • extra：（可选）任何其他元数据。

与MCP客户端一起使用

服务器运行后，将您的MCP客户端（例如AI助手或IDE插件）连接到它。客户端将发现可用的技能作为工具。

当代理使用技能工具时：

  1. 它提供了一个 task 描述。
  2. 服务器返回技能的说明和对任何包含资源的引用。
  3. 代理按照指示完成任务，可能通过MCP协议获取资源。

许可证

版权所有2025搜狐股份有限公司。

根据Apache许可证2.0版（“许可证”）许可； 除非遵守许可证，否则您不得使用此文件。 您可以在以下网址获得许可证副本

   http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则软件 根据许可证分发的内容按“原样”分发， 无任何明示或暗示的保证或条件。 请参阅许可证，了解管理权限和 许可证下的限制。

相关 MCP