MCP Chat Query

MCP运维云端

提供方 putupadang

运维云端 未标注 API Key 社区 / 第三方

一个基于Express.js和Next.js的生产就绪实现,展示LLM代理如何通过标准化协议与外部工具交互。

一句话选型结论

按资料字段整理

MCP Chat Query 属于运维云端类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

LLM代理JavaScript本地部署工具集成API服务JSONSchema验证MongoDB

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

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

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Chat Query当前 3 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

🚀 MCP聊天查询-模型上下文协议演示

生产就绪的实施 模型上下文协议(MCP) 配备Express.js服务器和Next.js前端。该项目演示了LLM代理如何通过标准化协议与外部工具进行交互。

📺 演示

  • 现场演示:[您的Vercel网址]
  • API文档:[您的服务器URL]/api文档
  • 演示视频:[您的YouTube/Drive链接]

✨ 特性

MCP服务器(Express.js)

  • 工具注册表:使用JSON模式验证的动态工具注册
  • OpenAPI规范:交互式Swagger UI文档
  • 认证:带有RBAC的基于API密钥的身份验证(基于角色的访问控制)
  • 速率限制:可配置的请求限制
  • 审计日志:完成工具调用跟踪
  • 结构化日志记录:使用Pino进行生产准备测井
  • 数据库:Prisma ORM+MongoDB(默认为本地)
  • 综合测试:单元和集成测试,覆盖率超过70%
  • Docker支持:生产就绪的集装箱化

前端(Next.js)

  • 交互式聊天界面:美观、反应灵敏的聊天界面
  • 工具可视化:实时显示工具调用和结果
  • 现代设计:Tailwind CSS+shadcn/ui组件
  • 类型安全:完全支持TypeScript
  • 服务器端API路由:安全的API密钥管理

开发运维

  • Docker Compose:多容器编排
  • GitHub 操作:自动化CI/CD管道
  • 容器注册表:自动构建Docker镜像
  • 健康检查:服务监控和自动重启

🏗️ 建筑```

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Next.js App │────────▶│ MCP Server │────────▶│ Tool Handlers │
│ (Frontend UI) │ HTTP │ (Express.js) │ │ (Business Logic)│
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ ▼ ▼
│ ┌──────────────┐ ┌────────────────┐
│ │ Validator │ │ MongoDB │
│ │ (AJV+Schema)│ │ (Prisma) │
└───────────────────▶└──────────────┘ └────────────────┘
API Routes │
▼
┌──────────────┐
│ Audit Log │
│ (Memory) │
└──────────────┘


## 🚀 快速开始

### 先决条件

- Node.js 18+
- npm或纱线
- Docker和Docker Compose(可选)
- MongoDB 6+(本地)或Docker(用于数据库)

### 选项1:本地运行

1. **克隆仓库**```bash
git clone https://github.com/YOUR_USERNAME/mcp-portfolio.git
cd mcp-portfolio
  1. 启动MCP服务器```bash
    cd server
    npm install
    cp .env.example .env

Edit .env with your API key (APP_API_KEY)

Ensure MongoDB is running locally:

- Docker: docker compose up -d mongo

- Homebrew (mac): brew services start mongodb-community

Initialize database (Prisma + MongoDB)

npm run prisma:generate
npm run prisma:push
npm run prisma:seed

Start development server

npm run dev

Server running on http://localhost:4000


3. **启动Next.js应用程序** (在新航站楼)```bash
cd app
npm install
cp .env.local.example .env.local
# Edit .env.local with server URL and API key
npm run dev
# App running on http://localhost:3000
  1. 访问应用程序
  • 前端:http://localhost:3000
  • API文件:http://localhost:4000/api-docs
  • 健康:http://localhost:4000/admin/health

选项2:使用Docker运行

docker compose中包含MongoDB服务;无需安装本地MongoDB。```bash

Set API key

export APP_API_KEY=your-secret-key

Start all services

docker-compose up -d

View logs

docker-compose logs -f

Stop services

docker-compose down


## 📚 API文档

### 可用工具

#### 1. **search_db** -搜索产品数据库(MongoDB+Prisma)```json
{
"tool": "search_db",
"input": {
"q": "laptop",
"category": "Electronics",
"limit": 5
}
}

2. 创建_票 -创建支持票(MongoDB)```json

{
"tool": "create_ticket",
"input": {
"title": "Login Issue",
"body": "Cannot login to my account",
"priority": "high"
}
}


#### 3. **run_query** -执行数据库查询(仅限管理员,模拟)```json
{
"tool": "run_query",
"input": {
"query": "SELECT * FROM products LIMIT 5"
}
}

核心终点

方法 端点 描述 需要身份验证
得到 /tools 列出所有可用工具 ✅
职位 /invoke 调用特定工具 ✅
职位 /agent/ask 向代理发送消息 ✅
得到 /admin/health 健康检查 ✅
得到 /admin/audit 获取审核日志 ✅
得到 /api-docs Swagger用户界面 ❌

认证

所有受保护的终结点都需要标头中的API密钥:```bash
curl -H "x-api-key: your-api-key" http://localhost:4000/tools


## 🧪 测试

### 运行服务器测试```bash
cd server
npm test              # Run all tests
npm run test:watch    # Watch mode
npm run test:coverage # With coverage

测试覆盖率

当前覆盖范围: 70%+ (分支、函数、行、语句)

🔒 安全特性

  • API密钥验证:安全的端点访问
  • 基于角色的访问控制:基于角色的工具权限(管理员、用户)
  • 速率限制:防止滥用(默认100个要求/分钟)
  • 输入验证:使用AJV进行JSON模式验证
  • 审计日志:跟踪所有工具调用
  • Helmet.js:安全标题
  • 跨域资源共享:可配置的来源白名单
  • 危险操作检测:防止破坏性查询

📊 演出

  • 工具执行:平均约100-200ms
  • 速率限制:100个请求/分钟(可配置)
  • 内存使用:每次服务约50MB
  • 并发请求:处理100+并发

🛠️ 技术栈

后端

  • Express.js -Web框架
  • 阿联酋 -JSON模式验证器
  • 皮诺 -结构化日志记录
  • Swagger用户界面 -API文件
  • 棱镜 -用于MongoDB的ORM/客户端
  • MongoDB -文档数据库
  • 测试 -测试框架

前端

  • Next.js 14 -React框架
  • TypeScript -类型安全
  • 尾风CSS -造型
  • Lucide图标 -图标库

开发运维

  • 码头工人 -集装箱化
  • GitHub 操作 -CI/CD
  • Docker Compose -编排

📁 项目结构```

mcp-portfolio/
├── server/ # Express.js MCP server
│ ├── src/
│ │ ├── config/ # Configuration
│ │ ├── middleware/ # Auth, audit, permissions
│ │ ├── routes/ # API routes
│ │ ├── tools/ # Tool registry & handlers
│ │ ├── validators/ # Schema validators
│ │ ├── db/ # Prisma client
│ │ └── index.js # Entry point
│ ├── prisma/ # Prisma schema & seed
│ ├── tests/ # Test suites
│ ├── Dockerfile
│ └── package.json
│
├── app/ # Next.js frontend
│ ├── app/
│ │ ├── api/chat/ # API routes
│ │ ├── globals.css # Global styles
│ │ ├── layout.tsx # Root layout
│ │ └── page.tsx # Home page
│ ├── components/ # React components
│ ├── lib/ # Utilities
│ ├── Dockerfile
│ └── package.json
│
├── .github/
│ ├── workflows/ # CI/CD pipelines
│ └── ISSUE_TEMPLATE/ # Issue templates
│
├── docs/ # Documentation
├── docker-compose.yml
├── LICENSE
└── README.md
```

🎯 路线图

  • []添加真正的LLM集成(OpenAI/Anthropic)
  • []实现RAG的矢量存储
  • []添加多步骤工具链
  • []实现工具结果缓存
  • []添加Kubernetes清单
  • []创建性能基准
  • []使用Playwright添加E2E测试
  • []实现WebSocket以实现实时更新
  • []添加更多工具示例(电子邮件、日历等)
  • []创建全面的视频教程

🤝 贡献

欢迎投稿!请查看我们的 贡献指南.

  1. 复刻仓库
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'feat: add amazing feature')
  4. 推到分支(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • 受模型上下文协议规范的启发
  • 采用现代最佳实践构建
  • 社区反馈和贡献

📧 联系

你的名字- @你的推特

项目链接: https://github.com/YOUR_USERNAME/mcp-portfolio


⭐ 标记此回购 如果你觉得有帮助的话!

内置于❤️ [你的名字]

常见问题

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

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

MCP Chat Query 怎么在客户端里配置?

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

MCP Chat Query 收费吗?

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

MCP Chat Query 需要 API Key 吗?

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

MCP Chat Query 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 LLM代理、API集成、JavaScript、MongoDB。具体工具清单以官方文档为准。

热门专题

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

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