Agentic MCP Prototype

MCPAI代理

提供方 PushpakMaheshwari1

AI代理 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

一个智能工作流自动化系统,使用AI动态规划和执行跨平台任务,提供多租户访问控制和安全认证。

一句话选型结论

按资料字段整理

Agentic MCP Prototype 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 9 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量9暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

工作流自动化Python本地部署跨平台任务AI规划RBAC多租户

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 9 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 9 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Agentic MCP Prototype当前 9 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方PushpakMaheshwari1上游标注的维护方 PushpakMaheshwari1
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.8 KB
来自项目仓库与上游目录的原文,未做删改

🐛 自动Bug路由器——代理MCP网关

一个使用人工智能动态规划和执行跨平台任务的智能工作流自动化系统。特性 身份验证+RBAC 用于安全的多租户访问控制。


它做什么

您键入一个简单的英文命令:```
Read ticket BUG-12 and post it to the dev channel


幕后:

1. **快速API** 从4台MCP服务器中发现可用工具
1. **双子座** 在运行时动态构建JSON执行计划(DAG)
1. **基于角色的访问控制** 在AI看到之前,根据用户角色过滤工具
1. FastAPI执行DAG:调用Jira MCP→ 注入结果→ 呼叫Slack MCP
1. WRITE工具暂停以获得Human In The Loop(HITL)批准
1. 每一步都通过SSE流式传输到浏览器中的实时终端

______________________________________________________________________

## 建筑```
Browser (Next.js :3000)
│
│  POST /execute  (natural-language command + JWT)
│  ◀─── SSE stream (logs, DAG, step events, RBAC events)
▼
FastAPI Orchestrator (:8000)
│
├── MCP SSE client ──▶  Jira Mock MCP  (:8081)
│                         • jira_get_ticket
│                         • jira_list_open_tickets
│
├── MCP SSE client ──▶  Slack Mock MCP (:8082)
│                         • slack_post_message
│
├── MCP SSE client ──▶  GitHub Mock MCP (:8083)
│                         • github_list_pull_requests
│                         • github_get_pull_request
│                         • github_create_issue
│
└── MCP SSE client ──▶  Sheets Mock MCP (:8084)
• sheets_read_range
• sheets_list_spreadsheets
• sheets_append_row

Auth+RBAC系统

角色和权限

角色 可以访问
实习生 Jira只读(jira_get_ticket, jira_list_open_tickets)
工程师 实习生工具+Slack帖子+GitHub阅读
高级的 工程师工具+表格(读/写)
管理员 所有工具+用户管理

RBAC流```

POST /execute { command, Authorization: Bearer }
│
▼ [JWT Middleware extracts user_id, role, tenant_id]
│
▼ Phase 1: Discover ALL tools from MCP servers
│
▼ [RBAC Check 1] Filter tools by role
│ Intern sees only 2/9 tools → Slack/GitHub/Sheets hidden from Gemini
│
▼ Phase 2: Gemini generates DAG using FILTERED tools
│
▼ Phase 3: Execute DAG steps
│ ├── [RBAC Check 2] is_tool_allowed(tool, role)?
│ │ NO → log violation, reject, return
│ │
│ ├── [HITL Gate] WRITE tool? → wait for human approval
│ │
│ └── invoke_tool() → result


______________________________________________________________________

## 快速开始

### 先决条件

- Docker 桌面版 已安装并正在运行

- A. Gemini API密钥 --自由层作品

- Docker+Docker组合

- Google Gemini API密钥

### 1.配置```bash
cd AgenticMcp
# Edit .env and set:
GEMINI_API_KEY=your-gemini-key
JWT_SECRET=any-random-string-for-jwt-signing

2.启动所有服务```bash

docker compose up --build


### 3.打开控制室```
http://localhost:3000
  • 注册 创建帐户(默认角色:实习生)
  • 登录 使用您的凭据
  • 键入命令并单击 执行→

测试用户

电子邮件 · 密码 · 角色
admin@test.com · password · 管理员(所有工具)
engineer@test.com · password · 工程师
senior@test.com · password 高级的
(注册新) · 任何 · 实习生


API终点

认证

方法 端点 描述
职位 /auth/signup 创建新帐户
职位 /auth/login 登录→ 获取JWT令牌
得到 /auth/me 获取当前用户信息

管理员(仅限管理员)

方法 端点 描述
得到 /admin/users 列出所有用户
补丁 /admin/users/{id}/role 更新用户角色

审核(仅限管理员)

方法 端点 描述
得到 /audit/rbac RBAC权限日志
得到 /audit/logins 登录尝试日志

执行

方法 端点 描述
得到 /tools 发现所有MCP工具
职位 /execute 执行自然语言命令

人在回路

方法 端点 描述
得到 /hitl/pending 列出待批准事项
职位 /hitl/{exec_id}/approve 批准一个步骤
职位 /hitl/{exec_id}/reject 拒绝步骤
得到 /hitl/audit HITL决策历史

调试

URL 您将看到什么
http://localhost:8081/health Jira模拟状态
http://localhost:8082/health 松弛模拟状态
http://localhost:8082/inbox 所有Slack消息
http://localhost:8083/health GitHub模拟状态
http://localhost:8084/health 表格模拟状态
http://localhost:8000/health 后端活性

SSE事件类型

type 有效载荷 UI效果
log level, message 终端输出
dag dag (JSON计划) 流程图渲染
rbac_filter role, visible_count, total_count 显示筛选工具
rbac_block tool, role 刀具堵塞警报
step_start step_id, tool 卡片突出显示琥珀色
step_complete step_id, output_key, result 卡片变绿
pending_approval execution_id, step_id, ... HITL模式
approved execution_id, step_id 继续执行
rejected execution_id, step_id 停止执行
error message 错误警报
complete outputs 工作流完成

预加载演示数据

Jira模拟门票:

ID 标题 状态 优先级
BUG-12 数据库超时问题 打开 高
BUG-13 移动设备上的登录重定向循环 正在进行中 中等

命令示例:```
Read ticket BUG-12 and post it to the #dev channel
List all open Jira tickets and notify #alerts on Slack
Get pull request #47 from acme-corp/backend and log to Sheets


______________________________________________________________________

## 文件结构```
AgenticMcp/
├── docker-compose.yml
├── .env
├── README.md
│
├── backend/
│   ├── main.py         # FastAPI: Auth + RBAC + Execution
│   ├── requirements.txt
│   └── Dockerfile
│
├── frontend/
│   ├── app/
│   │   ├── page.tsx    # UI + Auth + DAG viewer
│   │   ├── layout.tsx
│   │   └── globals.css
│   ├── package.json
│   └── Dockerfile
│
├── jira-mock/
│   ├── server.py
│   └── requirements.txt
│
├── slack-mock/
│   ├── server.py
│   └── requirements.txt
│
├── github-mock/
│   ├── server.py
│   └── requirements.txt
│
└── sheets-mock/
├── server.py
└── requirements.txt

不使用Docker运行

模拟MCP服务器```bash

Terminal 1

cd jira-mock && pip install -r requirements.txt && python server.py

Terminal 2

cd slack-mock && pip install -r requirements.txt && python server.py

Terminal 3

cd github-mock && pip install -r requirements.txt && python server.py

Terminal 4

cd sheets-mock && pip install -r requirements.txt && python server.py


### 后端```bash
cd backend
pip install -r requirements.txt
JIRA_MCP_URL=http://localhost:8081/sse \
SLACK_MCP_URL=http://localhost:8082/sse \
GITHUB_MCP_URL=http://localhost:8083/sse \
SHEETS_MCP_URL=http://localhost:8084/sse \
GEMINI_API_KEY=your-key \
JWT_SECRET=your-secret \
python main.py

# Tab 4 — Frontend
cd frontend && npm install
NEXT_PUBLIC_API_URL=http://localhost:8000 npm run dev

关键谈话要点

> “注意,我们从来没有写过 if 'BUG' in command: call_jira().
> LLM读取工具列表,并将逻辑本身以JSON的形式实时写入。
> 更改命令→ 计划改变了。添加工具→ 它被使用了。"

> “我们添加了具有两个强制点的Auth+RBAC:
>
> 1. 工具发现-在Gemini看到之前过滤工具
> 1. 执行门-在运行时阻止禁用工具
> 实习生只能阅读Jira——他们甚至从未将Slack视为一种选择!"

> “WRITE工具(如发布到Slack)会触发HITL批准。
> 在执行操作之前,必须得到人类的明确批准。
> 每次权限检查都会记录到SQLite中进行审核。"

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Agentic MCP Prototype 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Agentic MCP Prototype 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Agentic MCP Prototype 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Agentic MCP Prototype 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Agentic MCP Prototype 能提供哪些能力?

资料显示约 9 个工具;能力标签包括 工作流自动化、多租户、Python。具体工具清单以官方文档为准。

Agentic MCP Prototype 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Agentic MCP Prototype 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。