Ngsi V2 MCP

MCP安全风控

提供方 agaldemas

安全风控 未标注 无需鉴权 社区 / 第三方 CursorVS Code

一个基于Rust和Axum的模型上下文协议服务器实现,提供HTTP服务、资源管理、实时通信和安全功能,适用于AI模型交互和实时数据处理场景。

一句话选型结论

按资料字段整理

Ngsi V2 MCP 属于安全风控类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Cursor、VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

支持客户端

适用场景

模型交互Rust本地部署实时通信HTTP服务资源管理安全协议

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

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

值得选的地方

  • 已适配 Cursor、VS Code,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ngsi V2 MCP当前 未标注 未标注 未标注 无 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方agaldemas上游标注的维护方 agaldemas
分类安全风控本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

使用Rust和Axum实现的MCP(模型上下文协议)服务器。

特点/特性

  • HTTP服务器基于Axum的HTTP服务器,支持SSE(服务器发送事件)
  • MCP协议使用rmcp实现完整的模型上下文协议(Full Model Context Protocol)
  • 工具支持定义并提供用于人工智能模型交互的工具
  • 资源管理提供资源时,正确处理URI
  • 提示模板支持动态提示模板
  • 实时通信用于实时双向通信的SSE(Server-Sent Events)
  • 信号处理优雅地关闭并处理适当的信号
  • 安全为生产部署内置的安全功能

安全特性

这台服务器具备以下安全功能:

  • 交通运输安全为Web部署提供安全的SSE模式,支持配置绑定地址
  • 输入净化(或输入验证/输入清理)所有输入都经过了适当的验证和清理
  • 结构化日志记录JSON日志记录可防止日志注入攻击
  • 优雅关闭在终止信号时进行适当的清理
  • 错误处理安全的错误消息,不泄露实现细节

使用方法

基本用法```bash

Start the server in STDIO mode (default)

cargo run

Start the server in SSE mode with HTTP endpoints

cargo run -- --transport sse --sse-addr 127.0.0.1:8080

Start with custom configuration

cargo run -- --log-dir /var/log/mcp --api-url https://api.example.com

Use a configuration file

cargo run -- --config-file server.toml

Start with debug logging (standard Rust logging)

RUST_LOG=debug cargo run


### 配置

所有服务器配置均通过命令行参数完成:```
ngsi-v2-mcp [OPTIONS]

Options:
-t, --transport               Transport type to use [default: stdio] [possible values: stdio, sse]
--sse-addr                 SSE server bind address [default: 127.0.0.1:3300]
--sse-keep-alive     SSE keep-alive interval in seconds [default: 30]
--log-dir                   Log directory path [default: logs]
--api-url                   API URL for backend services [default: http://localhost:1026/]
-c, --config-file           Optional configuration file path (TOML format)
-h, --help                               Print help
-V, --version                            Print version

运输方式

STDIO模式 (默认):

  • 服务器通过标准输入/输出进行通信
  • 适用于直接的进程间通信
  • 被桌面版MCP客户端(如Cursor/VS Code)使用

SSE模式:

  • 服务器为SSE通信暴露了HTTP端点
  • /sse - 用于实时消息的服务器发送事件(Server-Sent Events)端点
  • /message - 客户端消息的POST端点
  • 适用于基于网络的客户端和远程连接

配置文件

如果你更倾向于使用配置文件(通过指定 --config-file),创建一个 TOML 文件:```toml
log_dir = "logs"
api_url = "http://localhost:1026/"
transport = "stdio"
sse_addr = "127.0.0.1:3300"
sse_keep_alive = 30


注:命令行参数总是会覆盖配置文件中的设置。

## API终端点

### MCP协议端点

- `POST /mcp/sse` - 用于MCP通信的服务器发送事件(Server-Sent Events)端点
- `GET /health` - 健康检查端点
- `GET /schema` - OpenAPI schema 端点

### 开发终点/开发目标

- `GET /docs` - Swagger UI 文档(仅限开发环境)

## 实施

### 添加工具

工具在(某处)中被定义 `src/handlers/` 并注册于 `src/main.rs`:```rust
use agenterra_rmcp::prelude::*;

#[tool]
async fn my_tool(
#[description("Input parameter")] input: String,
) -> Result> {
Ok(format!("Processed: {}", input))
}

添加资源

资源通过MCP协议进行管理,可以表示文件、数据库或任何可访问的数据:```rust
use agenterra_rmcp::prelude::*;

async fn list_resources() -> Vec {
vec![
Resource {
uri: "file:///example.txt".to_string(),
name: Some("Example File".to_string()),
description: Some("An example resource".to_string()),
mime_type: Some("text/plain".to_string()),
}
]
}


### 添加提示

可以为动态内容生成定义提示模板:```rust
use agenterra_rmcp::prelude::*;

async fn get_prompt(name: &str, args: &serde_json::Value) -> Option {
match name {
"example" => Some(PromptMessage {
role: MessageRole::User,
content: MessageContent::Text("Example prompt".to_string()),
}),
_ => None,
}
}

依赖项

  • rmcp(注:这个缩写在中文中没有直接对应的含义,它可能是一个特定领域或上下文中的术语,直译为“rmcp”或根据具体上下文可能需要意译为更具体的含义。)MCP协议实现
  • 阿克苏姆HTTP 网络框架
  • 追踪;追溯日志记录和仪器仪表
  • 信号钩优雅关闭时的信号处理

出版限制

⚠️(注意/警告) 重要的这个项目使用了git依赖,因此无法以当前形式发布到crates.io。

这个(或“该”) rmcp 直接从官方的 ModelContextProtocol GitHub 仓库引用依赖项,以确保能够访问最新功能(包括身份验证支持)。要将此项目发布到 crates.io,您需要:

  1. 等待官方(消息/通知) rmcp 在 crates.io 上发布的版本,其中包含 auth 特性;特点
  2. 或者移除那些需要 git 依赖的特性
  3. 或者在本地提供依赖项

这一限制确保您在开发过程中能够访问完整的、官方的MCP SDK功能。

发展

建筑```bash

cargo build


### 运行测试```bash
cargo test

格式化```bash

cargo fmt


### 代码检查(或代码格式化/代码规范检查)```bash
cargo clippy

运行时热重载

对于开发,你可以使用 cargo watch:```bash
cargo install cargo-watch
cargo watch -x run


## 项目结构```
ngsi-v2-mcp/
├── Cargo.toml          # Rust project manifest
├── src/
│   ├── handlers/        # MCP request handlers
│   │   ├── mod.rs       # Handler module exports
│   │   └── {endpoint}.rs # Individual endpoint handlers
│   ├── schemas/         # JSON schema files (created during generation)
│   ├── common.rs        # Common utilities and error handling
│   ├── config.rs        # Server configuration
│   ├── server.rs        # MCP server implementation
│   ├── signal.rs        # Signal handling for graceful shutdown
│   ├── transport.rs     # Transport layer (STDIO/SSE)
│   └── main.rs          # Server entry point
├── .env                # Environment variables
└── README.md           # Project documentation

该结构组织如下:

  • handlers/ - 包含所有MCP工具的实现,每个端点对应一个文件
  • schemas/ - 工具参数的JSON模式文件(自动生成)
  • common.rs API通信和错误处理的共享实用程序
  • config.rs - 配置管理和命令行解析
  • server.rs - 核心MCP服务器实现,包含协议处理功能
  • signal.rs - 优雅关闭时的信号处理(SIGTERM,SIGINT)
  • transport.rs - 支持STDIO和SSE模式的传输层
  • main.rs - 应用程序入口点和服务器初始化

生产部署

构建发布二进制文件```bash

cargo build --release


### Docker 部署

创建一个 `Dockerfile`:```dockerfile
FROM rust:1.70 as builder
WORKDIR /app
COPY . .
RUN cargo build --release

FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
COPY --from=builder /app/target/release/ngsi-v2-mcp /usr/local/bin/server
EXPOSE 3000
CMD ["server"]

环境配置

对于生产,考虑以下因素:

  • 设定适当的 RUST_LOG 层级;水平
  • 配置适当的错误处理
  • 建立监控和指标体系
  • 实施速率限制
  • 添加认证中间件

许可证

此项目遵循MIT许可协议。

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ngsi V2 MCP 怎么在 Cursor、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ngsi V2 MCP 收费吗?

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

Ngsi V2 MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Ngsi V2 MCP 支持哪些客户端?

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

Ngsi V2 MCP 能提供哪些能力?

资料显示能力标签包括 模型交互、安全协议、Rust、Cursor、实时通信。具体工具清单以官方文档为准。

热门专题

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

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