NagaAgent

用 MCP 和工具调用，快速搭一个能干活的私人 AI 助手

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 165 🐛 待处理 4 👀 关注 15

GitHub ↗

GitHub 星标 ★ 1544

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，官网为B站主页非产品站

项目预览

项目数据

分类智能体

开发团队RTGS2017

GitHubhttps://github.com/RTGS2017/NagaAgent

定价模式🏷️完全免费

价格说明开源免费，官网为B站主页非产品站

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议AGPL-3.0

主要语言Python

技术栈/模型agentic-ai,agents,mcp,mcp-client,openai,openclaw,toolcall

GitHub 星标★ 1544

上线时间2025-04-20 00:00:00

代码更新2026-11-01

仓库体积240.3 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-11-03

浏览次数0

项目介绍

NagaAgent 是一个面向个人助手的轻量级智能体框架，用 Python 编写。它要解决的是把大模型能力落地为可日常使用的私人助理时，工具调用、多智能体协作和外部服务接入各自为政的问题。核心能力包括：基于 OpenAI 兼容接口的对话与推理；通过 MCP（Model Context Protocol）客户端接入外部工具与数据源，让助手能调用搜索、文件、系统操作等能力；支持多智能体分工协作，把复杂任务拆给不同角色处理；提供工具调用（toolcall）编排，把模型输出转化为实际动作。项目定位是“简单但强大”，配置门槛较低，适合开发者快速搭起一个可扩展的个人助理原型，再按需挂载自己的工具与技能。整体偏向个人场景与二次开发，代码结构清晰，便于阅读和改造。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-03 · 当前星标 ★ 1544

技术标签

agentic-ai agents mcp mcp-client openai

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 20 分钟部署方式：本地安装 6 步

环境要求

Python 环境（项目后端用 Python 编写，README 未给出具体版本与依赖安装命令）
Node.js 与 npm（用于在 frontend 目录执行 npm install 和 npm run dev）
一个 OpenAI 兼容 API 的 API Key（如 DeepSeek、通义千问、Ollama 等）
可选：Neo4j（用于知识图谱记忆；不配置时改用本地 JSON 存储）

安装与启动步骤

1克隆项目代码

用 README 给出的仓库地址拉取代码，并进入项目根目录。
```
git clone https://github.com/Xxiii8322766509/NagaAgent.git
cd NagaAgent
```
2安装前端依赖

进入 frontend 目录用 npm 安装依赖，完成后回到项目根目录。
```
cd frontend
npm install
cd ..
```
3生成配置文件

把 config.json.example 复制为 config.json，配置文件以项目根目录这份为优先。
```
cp config.json.example config.json
```
4填写模型 API 配置

编辑 config.json 的 api 段，替换 api_key、base_url、model 等字段。
5按需开启 Neo4j 记忆

想用知识图谱记忆就装 Neo4j 并填 grag 段；不装则用本地 JSON 存储。
6启动前端

在 frontend 目录运行开发脚本，README 说明该项目已配置一键启动。
```
cd frontend && npm run dev
```

关键配置

配置项	必填	说明	示例
`api.api_key`	是	模型服务的密钥；占位值会被后端拒绝代理请求	`sk-xxxxxxxxxxxxxxxx`
`api.base_url`	是	OpenAI 兼容接口的服务地址	`https://api.deepseek.com`
`api.model`	是	调用的模型名称	`deepseek-v3.2`
`api.api_format`	否	接口格式，openai 或 anthropic	`openai`
`api.use_gateway`	否	是否走 NagaModel 网关；用本地密钥时设为 false	`false`
`grag.enabled`	否	是否启用 Neo4j 知识图谱记忆	`true`