NekroAgent
NekroAgent 是 AI Skill Hub 本期精选MCP工具之一。综合评分 8.5 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。
📚 深度解析
通过安装 NekroAgent，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。
在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。NekroAgent 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。
与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 NekroAgent 评为 AI 评分 8.5 分，属于同类工具中的优质选择。
📋 工具概览
NekroAgent 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
📖 中文文档
NekroAgent 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
- 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
- 提供结构化工具调用接口，显著降低 AI 集成复杂度
- 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
- 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
- 轻量无侵入设计，不影响现有系统架构
- 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
- 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
- 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/KroMiose/nekro-agent
# 方式二：手动配置 claude_desktop_config.json
{
"mcpServers": {
"nekroagent": {
"command": "npx",
"args": ["-y", "nekro-agent"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
- 确认已安装 Node.js（v18 或以上版本）
- 打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
- 按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
- 保存配置文件并重启 Claude 客户端
- 重启后，在对话中即可使用本工具
# 安装后在 Claude 对话中直接使用 # 示例： 用户: 请帮我用 NekroAgent 执行以下任务... Claude: [自动调用 NekroAgent MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入："列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"nekroagent": {
"command": "npx",
"args": ["-y", "nekro-agent"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
Nekro Agent - 更智能、更优雅的代理执行 AI
Switch to English
🚅 源自首批大模型机器人应用 Naturel GPT 的 Agent 升级重构续作 🌈
📚 Nekro Agent 文档中心 提供完整的入门指南与开发文档 📚
💬 技术交流/答疑 -> 加入社区 QQ 交流群: 636925153 (1群) | Discord Channel 🗨️
🚀 NekroAI 云社区 提供插件和人设实时自由共享，生态观测功能等你体验！ 🚀
🚀 核心能力
NekroAgent 通过强大灵活的提示词构建系统，引导 AI 生成准确的代码并在沙盒中执行，通过 RPC 通信来与真实环境交互。主要特点包括：
核心执行与扩展能力:
- 代码生成与安全沙盒：引导 AI 生成代码并在安全的容器化环境中执行，实现复杂任务与方法级扩展性的坚固基石！
- 高度可扩展的插件系统：提供多种关键节点回调、提示词注入、自定义沙盒方法，从小型工具扩展到大型系统优雅集成的超智能中枢解决方案！
- 原生多人场景互动：高效洞悉群聊场景需求，在复杂的多人对话中保持交互能力！
- 极致的降本增效：拒绝无效提示词与滥用迭代智能体，聚焦解决问题的逻辑根本。
- 自动纠错与反馈：深耕提示词纠错与反馈机制，打破困于错误与重复的循环。
连接与交互:
- 多平台适配器架构：原生支持
OneBot v11(QQ)、Discord、Telegram、Minecraft、B站直播、微信、邮件及SSE+SDK等多种聊天平台，提供统一的开发接口。 - 原生多模态视觉理解：可处理图片、文件等多种资源，与用户进行多模态交互。
- 基于事件驱动的异步架构：遵循异步优先的高效响应机制。
生态与易用性:
- 云端资源共享：包括插件、人设等，拥有强大友好的社区驱动能力。
- 功能齐全的可视化界面：提供强大的应用管理与监控面板。
🧪 预览版新特性
以下内容为当前 main / preview 版本中的重点新能力：
- 全新工作区 / Claude Code 沙盒体系（预览版）：统一管理提示词、技能、模型预设、文件、扩展、MCP、沙盒与运行状态，面向更完整的 Agent 工作流。
- Memory System 长期记忆（预览版）：引入实体、关系、段落、episode、向量检索与重建维护机制，为 Agent 提供可持续沉淀的长期上下文能力。
- 结构化 MCP 服务管理（预览版）：新增 registry 与卡片式管理界面，让外部工具与 MCP 服务接入更清晰、更可控。
- 命令系统重构（预览版）：命令注册、解析、分组、补全、输出查看与前端管理能力完成一轮系统化升级。
- 定时器与运行治理增强（预览版）：新增 timers 管理、停止回复流程、频道配额与插件激活策略，提升自动化和可运营性。
- WebUI 与实时状态体验升级（预览版）：聊天消息样式、SSE 实时推送、系统事件、Agent 活动卡片、工作区导航与多语言支持都有明显增强。
💡 功能列表
- ✅ 多平台适配：
- ✅ OneBot v11 (QQ)
- ✅ Discord
- ✅ Telegram
- ✅ Minecraft
- ✅ Bilibili Live (B 站直播)
- ✅ WeChat (微信，通过 WeChatPad)
- ✅ Email (邮件，SMTP/IMAP)
- ✅ SSE+SDK (Server-Sent Events + SDK)
- ✅ ... 更多适配器开发中
- ✅ 智能聊天：群聊/私聊场景下的上下文智能聊天
- ✅ 自定义人设：支持自定义人设与云端人设市场
- ✅ 沙盒执行：安全的容器化代码执行环境
- ✅ 多模态交互：支持发送、接收和处理图片及文件资源
- ✅ 插件生态：高度可扩展的插件系统与云端插件市场
- ✅ 一键部署：基于
docker-compose的容器编排一键部署 - ✅ 热重载：配置热更新与指令控制支持
- ✅ 定时任务：支持定时自触发插件与节日祝福
- ✅ WebUI：功能齐全的可视化应用管理控制面板
- ✅ 事件支持：可响应多种平台事件通知并理解其上下文
- ✅ 外置思维链 (CoT) 能力支持
- ✅ 完善第三方插件能力及 AI 生成插件
- 🧪 工作区 / Claude Code 沙盒（预览版）：统一管理沙盒任务、提示词、技能、模型预设、文件与扩展
- 🧪 Memory System（预览版）：长期记忆、向量检索、记忆维护与可视化管理面板
- 🧪 结构化 MCP 管理（预览版）：MCP 服务注册、共享配置与可视化卡片管理
- 🧪 命令管理中心（预览版）：新命令系统、命令输出页与可视化管理界面
🎁 快速部署
我们提供了多种部署方式，请访问 快速开始文档 查看详细教程：
一键部署脚本 (推荐)
从 Github (推荐)
sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install.sh)" - --with-napcat如果从 Github 下载脚本遇到网络问题，您可以使用 Nekro Endpoint 的边缘代理访问地址：
从 NekroEndpoint (Cloudflare 镜像)
sudo -E bash -c "$(curl -fsSL https://ep.nekro.ai/e/KroMiose/nekro-agent/main/docker/install.sh)" - --with-napcat提示:
上述命令中的 --with-napcat 参数会启动全自动标准部署。 如果不加此参数，脚本会以交互模式启动，届时请选择 Y 以安装 Napcat。
Docker 镜像说明
Nekro Agent 提供两种 Docker 镜像标签，同时发布到 Docker Hub 和 GitHub Container Registry (GHCR)：
- latest: 稳定版本，基于 tag 发布，适用于生产环境
- preview: 预览版本，每次 main 分支更新自动构建，包含最新功能，适用于测试和开发
从 Docker Hub 拉取（推荐）
```bash
⚙️ 效果演示
Nekro Agent 提供了强大而直观的可视化界面，方便您管理和监控 Agent 的所有行为，以及实现多种精细化的 Agent 行为策略控制等。
使用稳定版本（推荐）
docker pull kromiose/nekro-agent:latest
使用预览版本（体验最新功能）
docker pull kromiose/nekro-agent:preview
#### 从 GitHub Container Registry 拉取
使用稳定版本
docker pull ghcr.io/kromiose/nekro-agent:latest
使用预览版本
docker pull ghcr.io/kromiose/nekro-agent:preview ```
📘 API 文档与响应规范
启用 --docs 参数后可访问：
- Swagger UI: http://localhost:8021/api/docs
- ReDoc: http://localhost:8021/api/redoc
API 使用标准 HTTP 状态码，错误响应为结构化格式并支持 Accept-Language：
{
"error": "ValidationError",
"message": "参数校验失败",
"detail": "field: error detail",
"data": null
}📖 常见问题
常见问题及解答请访问 故障排除与 FAQ
高质量的开源MCP工具，功能丰富
⚡ 核心功能
- 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
- 提供结构化工具调用接口，显著降低 AI 集成复杂度
- 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
- 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
- 轻量无侵入设计，不影响现有系统架构
👥 适合人群
🎯 使用场景
- 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
- 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
- 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
⚖️ 优点与不足
- +标准化 MCP 协议，生态互联性强
- +与 Claude 官方生态无缝对接
- +即插即用，配置简单快捷
- −依赖 Claude 客户端，非 Claude 用户无法使用
- −MCP 协议仍在持续演进，接口可能变更
- −需要一定的配置步骤
该工具使用 NOASSERTION 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
📄 NOASSERTION — 请查阅原始协议条款了解具体使用限制。
❓ 常见问题 FAQ
经综合评估，NekroAgent 在MCP工具赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | nekro-agent |
| Topics | mcpagentaichatbot |
| GitHub | https://github.com/KroMiose/nekro-agent |
| License | NOASSERTION |
| 语言 | Python |
收录时间：2026-06-08 · 更新时间：2026-06-08 · License：NOASSERTION · AI Skill Hub 不对第三方内容的准确性作法律背书。