Junos MCP Server On A Linux Bastion

MCP开发工具

提供方 kbedford

开发工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

通过MCP和HTTP协议集中管理Junos路由器的CLI命令,避免逐个SSH连接。

一句话选型结论

按资料字段整理

Junos MCP Server On A Linux Bastion 属于开发工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

网络管理本地部署CLI工具路由器管理自动化运维Junos

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
python -m pip install --upgrade pip

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Junos MCP Server On A Linux Bastion当前 1 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

Junos-MCP-小型堡垒服务器

通过MCP+HTTP集中Junos CLI*

Linux Bastion上的Junos MCP服务器

通过MCP+HTTP集中Junos CLI

此README描述了如何设置 Junos MCP服务器 在Linux主机(通常是堡垒/跳转服务器)上,操作团队可以:

  • 发送 Junos CLI命令 通过MCP连接到路由器
  • 使用 HTTP+JSON (或一个简单的shell助手)获取实时输出
  • 避免单独使用SSHing到每个路由器

本文件 不 涵盖任何编辑器/IDE集成——它纯粹专注于直接在Linux主机上运行所有内容。


1.架构概述

  • 堡垒主机 (Linux):

  • 运行Junos MCP服务器(jmcp.py)在Python虚拟环境中。

  • 在本地公开HTTP MCP端点 127.0.0.1:30030.
  • 提供shell帮助程序 jmcp_cli 让运维工程师通过MCP运行Junos CLI命令。

  • Junos路由器:

  • 可从堡垒访问(例如管理IP)。

  • 定义于a devices.json 包含凭据和连接详细信息的文件。

高水位流量:

  1. 行动工程师SSHe前往堡垒。
  2. 跑 jmcp_cli "show bgp summary | no-more".
  3. Bastion发送MCP tools/call 通过HTTP向MCP服务器发送请求。
  4. MCP服务器连接到Junos路由器,运行CLI命令并返回输出。
  5. 辅助函数将CLI文本打印回操作员。

2.先决条件

在堡垒主机上,您需要:

  • Linux(以下示例使用Ubuntu 22.04)
  • python 3.11
  • python3-pip 和 python3.11-venv
  • git
  • curl
  • jq (用于解析JSON并提取CLI输出)

安装核心工具(根据需要调整您的环境/存储库):```bash
apt update
apt install -y \
git \
python3.11 \
python3-pip \
python3.11-venv \
curl \
jq


> 如果您的环境使用内部镜像(例如。 `repo.juniper.net`),确保 `apt` 相应地进行配置。

______________________________________________________________________

## 3.克隆Junos MCP服务器存储库

为工具选择一个目录,例如。 `/root`:```bash
cd /root
git clone https://github.com/Juniper/junos-mcp-server.git
cd junos-mcp-server

ls
# CLAUDE.md  Dockerfile  jmcp.py  jmcp_token_manager.py  pyproject.toml
# devices-template.json  requirements.txt  ...

4.创建并激活Python虚拟环境

为MCP服务器创建隔离环境:```bash
cd /root/junos-mcp-server
python3.11 -m venv .venv
source .venv/bin/activate

which python

/root/junos-mcp-server/.venv/bin/python


升级 `pip` (可选但推荐):```bash
python -m pip install --upgrade pip

5.安装MCP服务器依赖项

虚拟环境处于活动状态时:```bash
cd /root/junos-mcp-server
pip install -r requirements.txt


如果您稍后看到以下错误:```text
ModuleNotFoundError: No module named 'pydantic'

这通常意味着你不在虚拟环境中。重新运行:```bash
cd /root/junos-mcp-server
source .venv/bin/activate


______________________________________________________________________

## 6.配置设备(`devices.json`)

从提供的模板开始:```bash
cd /root/junos-mcp-server
cp devices-template.json devices.json

编辑 devices.json:```bash
vi devices.json


单个路由器的示例:```json
{
"vmx101": {
"ip": "10.38.171.252",
"port": 22,
"username": "ken",
"auth": {
"type": "password",
"password": "junos123"
}
}
}

替换为您自己的详细信息:

  • "ip" –Junos设备的管理IP/主机名
  • "port" SSH端口(通常 22)
  • "username" / "password" –Junos以适当的权限登录

您可以将多个路由器定义为:```json
{
"vmx101": { ... },
"vmx102": { ... },
"core-mx1": { ... }
}


______________________________________________________________________

## 7.启动MCP服务器(HTTP/Streamable)

当venv处于活动状态时:```bash
cd /root/junos-mcp-server
source .venv/bin/activate

python jmcp.py -f devices.json -t streamable-http -H 127.0.0.1

您应该看到类似以下内容的日志:```text
WARNING - No .tokens file found - server is open to all clients
INFO - All 1 device(s) validated successfully
INFO - Successfully loaded and validated 1 device(s)
INFO - Streamable HTTP server started on http://127.0.0.1:30030
Uvicorn running on http://127.0.0.1:30030 (Press CTRL+C to quit)


让此进程在该终端中运行。

> 🔐 **安全说明:**
> 没有 `.tokens` 文件,任何可以访问的进程 `127.0.0.1:30030` 可以与此MCP服务器通信。
> 在单用户堡垒上,这通常很好。在共享环境中,考虑使用以下配置令牌 `jmcp_token_manager.py`.

______________________________________________________________________

## 8.初始化MCP会话并捕获会话ID

打开A **第二** SSH会话到同一堡垒主机。

运行MCP `initialize` 呼叫:```bash
curl -i \
-X POST "http://127.0.0.1:30030/mcp/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": { "name": "curl", "version": "1.0" }
}
}'

您应该看到这样的响应:```http
HTTP/1.1 200 OK
date: ...
server: uvicorn
content-type: text/event-stream
mcp-session-id: f98a307fce164ec2af8c49e43b1fc664
...

event: message
data: {"jsonrpc":"2.0","id":1,"result":{...}}


关键部分是标题:```http
mcp-session-id: f98a307fce164ec2af8c49e43b1fc664

将其作为环境变量导出到shell中:```bash
export MCP_SESSION=f98a307fce164ec2af8c49e43b1fc664
echo "$MCP_SESSION"

f98a307fce164ec2af8c49e43b1fc664


> 🔁 **重要提示:**
> 每次重新启动时 `jmcp.py`,您必须:
>
> 1. 呼叫 `initialize` 再次,以及
> 1. 更新 `MCP_SESSION` 随着新 `mcp-session-id`.

______________________________________________________________________

## 9.创建一个 `jmcp_cli` 辅助功能

为了使MCP服务器易于运维团队使用,添加一个shell函数:

- 发送MCP `tools/call` 请求通过 `curl`
- 剥去 `data:` 来自服务器发送事件(SSE)的前缀
- 用途 `jq` 仅提取Junos CLI文本

此功能的作用

在较高层次上,jmcp_cli:

1. 接受Junos CLI命令作为参数

- 例如jmcp_cli“显示bgp摘要|不再显示”
- 完整字符串存储在cmd中并传递给MCP服务器。

2. 确保命令和MCP会话有效

- 如果你忘记传递命令,它会打印:
用法:jmcp_cli

- 如果未设置MCP_SESSION(您尚未运行初始化调用),它会提醒您这样做。

1. 通过HTTP调用MCP服务器

- 向发送JSON-RPC工具/调用请求http://127.0.0.1:30030/mcp/.
- 对路由器vmx101(在devices.json中定义)使用execute_junos_command工具。
- 包含Mcp会话Id:$Mcp_Session标头,以便服务器知道要使用哪个Mcp会话。

4. 清理响应并仅打印CLI文本

- 服务器响应为服务器发送事件(SSE),行类似于event:。..和数据:{…}。
- sed去掉了前导数据:所以我们只剩下纯JSON。
- jq选取.result.content\[0\].text(Junos CLI输出)并将其作为普通文本打印出来。

从操作员的角度来看,所有这些都是隐藏的。一旦设置了MCP_SESSION并加载了jmcp_cli,它们就会运行:```
jmcp_cli "show chassis routing-engine | no-more"
jmcp_cli "show bgp summary | no-more"
jmcp_cli "show interfaces terse | no-more"

编辑您的bash配置:```bash
vi ~/.bashrc


附上以下内容:```bash
jmcp_cli() {
local cmd="$*"

if [ -z "$cmd" ]; then
echo "Usage: jmcp_cli "
return 1
fi

if [ -z "$MCP_SESSION" ]; then
echo "Error: MCP_SESSION not set. Run the MCP initialize curl and export MCP_SESSION first."
return 1
fi

curl -s "http://127.0.0.1:30030/mcp/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: $MCP_SESSION" \
-d "{
\"jsonrpc\": \"2.0\",
\"id\": 10,
\"method\": \"tools/call\",
\"params\": {
\"name\": \"execute_junos_command\",
\"arguments\": {
\"router_name\": \"vmx101\",
\"command\": \"${cmd}\"
}
}
}" \
| sed -n 's/^data: //p' \
| jq -r '.result.content[0].text // .data.result.content[0].text'
}

输出示例如下```
root@ansible:~# curl -i \
-X POST "http://127.0.0.1:30030/mcp/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": { "name": "curl", "version": "1.0" }
}
}'
HTTP/1.1 200 OK
date: Wed, 03 Dec 2025 16:04:58 GMT
server: uvicorn
cache-control: no-cache, no-transform
connection: keep-alive
content-type: text/event-stream
mcp-session-id: f98a307fce164ec2af8c49e43b1fc664
x-accel-buffering: no
Transfer-Encoding: chunked

event: message
data: {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities":{"experimental":{},"prompts":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"tools":{"listChanged":false}},"serverInfo":{"name":"jmcp-server","version":"1.0.0"}}}


重新加载shell配置:```bash
source ~/.bashrc
type jmcp_cli
# jmcp_cli is a function

> 📝 上面的示例被硬编码为 router_name: "vmx101".
> 如果你有多个路由器,你可以创建一个 jmcp_cli_r "" 稍后的变体。


10.使用 jmcp_cli 运行Junos CLI命令

一次:

  • jmcp.py 正在堡垒上奔跑
  • MCP_SESSION 已设置
  • jmcp_cli 已装入您的壳中

…你可以运行这样的命令:

输出示例:```bash
root@ansible:~# jmcp_cli "show chassis routing-engine | no-more"

Routing Engine status:
Slot 0:
Current state Master
Election priority Master (default)
DRAM 4042 MB (4096 MB installed)
Memory utilization 11 percent
5 sec CPU utilization:
User 1 percent
Background 0 percent
Kernel 1 percent
Interrupt 1 percent
Idle 97 percent
1 min CPU utilization:
User 1 percent
Background 0 percent
Kernel 2 percent
Interrupt 1 percent
Idle 96 percent
5 min CPU utilization:
User 1 percent
Background 0 percent
Kernel 2 percent
Interrupt 1 percent
Idle 96 percent
15 min CPU utilization:
User 1 percent
Background 0 percent
Kernel 2 percent
Interrupt 1 percent
Idle 96 percent
Model RE-VMX
Serial ID 907311d8-cf
Start time 2025-12-02 06:49:05 PST
Uptime 1 day, 1 hour, 33 minutes, 3 seconds
Last reboot reason Router rebooted after a normal shutdown.
Load averages: 1 minute 5 minute 15 minute
0.06 0.17 0.16

root@ansible:~# jmcp_cli "show bgp summary "

Threading mode: BGP I/O
Default eBGP mode: advertise - accept, receive - accept
Groups: 1 Peers: 6 Down peers: 0
Table Tot Paths Act Paths Suppressed History Damp State Pending
inet.0
36 36 0 0 0 0
bgp.l3vpn.0
12 12 0 0 0 0
bgp.l2vpn.0
4 4 0 0 0 0
bgp.evpn.0
0 0 0 0 0 0
Peer AS InPkt OutPkt OutQ Flaps Last Up/Dwn State|#Active/Received/Accepted/Damped...
11.0.0.102 11 3413 3412 0 0 1d 1:56:26 Establ
inet.0: 6/6/6/0
bgp.l3vpn.0: 4/4/4/0
bgp.l2vpn.0: 0/0/0/0
bgp.evpn.0: 0/0/0/0
vpn_0.inet.0: 4/4/4/0
l2vpn_3.l2vpn.0: 0/0/0/0
vpn_200.l2vpn.0: 0/0/0/0
11.0.0.103 11 3385 3382 0 0 1d 1:42:55 Establ
inet.0: 6/6/6/0
bgp.l3vpn.0: 4/4/4/0
bgp.l2vpn.0: 1/1/1/0
bgp.evpn.0: 0/0/0/0
vpn_0.inet.0: 4/4/4/0
l2vpn_3.l2vpn.0: 0/0/0/0
vpn_200.l2vpn.0: 1/1/1/0
11.0.0.104 11 3385 3381 0 0 1d 1:42:37 Establ
inet.0: 6/6/6/0
bgp.l3vpn.0: 4/4/4/0
bgp.l2vpn.0: 2/2/2/0
bgp.evpn.0: 0/0/0/0
vpn_0.inet.0: 4/4/4/0
l2vpn_3.l2vpn.0: 1/1/1/0
vpn_200.l2vpn.0: 1/1/1/0
11.0.0.105 11 3411 3413 0 0 1d 1:57:31 Establ
inet.0: 6/6/6/0
bgp.l2vpn.0: 0/0/0/0
bgp.evpn.0: 0/0/0/0
l2vpn_3.l2vpn.0: 0/0/0/0
vpn_200.l2vpn.0: 0/0/0/0
11.0.0.106 11 3377 3377 0 0 1d 1:41:19 Establ
inet.0: 6/6/6/0
bgp.l2vpn.0: 1/1/1/0
bgp.evpn.0: 0/0/0/0
l2vpn_3.l2vpn.0: 0/0/0/0
vpn_200.l2vpn.0: 1/1/1/0
11.0.0.107 11 3377 3379 0 0 1d 1:42:05 Establ
inet.0: 6/6/6/0
bgp.l3vpn.0: 0/0/0/0
bgp.l2vpn.0: 0/0/0/0
l2vpn_3.l2vpn.0: 0/0/0/0
vpn_200.l2vpn.0: 0/0/0/0

```

从运营商的角度来看,他们只是:

  1. SSH到堡垒
  2. 确保 MCP_SESSION 已设置(或运行执行此操作的包装器)
  3. 使用 jmcp_cli "" 与路由器交互


11.总结

这种设置将Linux堡垒变成了 Junos的中央MCP网关:

  • 单个SSH入口点 对于运营团队

  • HTTP+JSON 通往朱诺庄园的北行接口

  • 简单 jmcp_cli shell助手,以便操作员可以:

  • 避免直接SSH到每个路由器

  • 运行标准显示命令
  • 在MCP之上构建小脚本/健康检查

此README有意停留在CLI+HTTP层。

同一个MCP服务器以后可以与IDE、聊天代理或其他工具集成,但“堡垒MCP服务器”的核心模式+ jmcp_cli“已经提供了强大的操作流程。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Junos MCP Server On A Linux Bastion 怎么安装?

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

Junos MCP Server On A Linux Bastion 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Junos MCP Server On A Linux Bastion 收费吗?

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

Junos MCP Server On A Linux Bastion 需要 API Key 吗?

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

Junos MCP Server On A Linux Bastion 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Junos MCP Server On A Linux Bastion 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 网络管理、Python、Claude、命令行工具。具体工具清单以官方文档为准。

Junos MCP Server On A Linux Bastion 需要什么运行环境?

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

Junos MCP Server On A Linux Bastion 是本地还是远程?

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

热门专题

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

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