MCP Server · 运维云端

MCP Server Generic

一个基于Kotlin/Spring的单一数据访问MCP服务器，具有薄层MCP工具处理程序和可插拔的域适配器，适用于多源数据集成和查询。

未说明官方级别未说明来源级核验工具 4

Kotlin数据集成微服务Spring Boot

快速开始

公开资料没有提供安装命令，按仓库或官方文档接入。

打开主来源页面 GitHub 仓库

作者 / 组织: AravinthhKrish
提供方: AravinthhKrish

工具数量

来源目录标注

资源数量

来源目录标注

提示词数量

来源目录标注

GitHub Star

仓库热度

收录来源

1 个

MCP World

选型结论

MCP Server Generic 属于运维云端类 MCP Server，公开资料标注 4 个工具，通过传输方式未标注接入，客户端适配情况以官方文档为准，没有现成的安装命令；接入前要先准备 OAuth 授权。

分类

运维云端

传输方式

未说明

认证方式

OAuth 授权

部署方式

公开资料未说明

安装与配置

公开目录没有给出安装命令，需要按仓库 README安装；下面按同类条目的通用流程说明。

公开命令不是通用的启动方式，拼不出可靠配置示例；请在客户端 MCP 配置里按官方文档填写 command 和 args。

上手步骤

1
先确认运行方式
公开资料没有标注传输方式，先看仓库 README，确认是本地进程还是远程地址。
2
获取服务
公开目录没有给出安装命令，按仓库 README里的步骤安装或获取服务。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 4 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

公开资料仍需确认：安装命令

详细介绍

mcp服务器通用

Kotlin/Spring启动器的实现 单数据访问MCP服务器 使用精简的MCP工具处理程序和可插拔的域适配器。

架构（4层）

MCP层

- 工具端点（第一阶段）： - drive.search_files - gmail.search_messages - news.search_articles - market.quote - 资源终结点： - resource://news/sources - resource://system/provider-health

域适配器

- GoogleDriveAdapter - GmailAdapter - NewsAdapter - MarketDataAdapter

认证层

- 访问上下文和令牌存储抽象。

缓存/事件层

- 缓存服务抽象（MVP的内存实现）。

实施计划

第一阶段（已实施）

Bootstrap Kotlin+Spring Boot应用程序。
添加规范化域模型：

- DriveFile, MailMessage, Article, Quote.

为以下对象添加工具合同和处理程序：

- drive.search_files - gmail.search_messages - news.search_articles - market.quote

添加适配器接口和存根实现。
为报价响应添加短期缓存。
添加基本集成测试 market.quote.

第二阶段（下）

添加 drive.read_file_text, gmail.get_thread, market.quotes_batch, news.get_topic_digest.
添加分页标记持久性和更强的结果新鲜度元数据。
添加Redis支持的缓存实现。

第三阶段（下一阶段）

驱动器/Gmail手表集成。
市场WebSocket流消费者。
提供程序路由+故障转移策略。
源注册表持久化和项目删除管道。

封装结构

src/main/kotlin/com/example/mcp
├── auth
├── cache
├── domain
│   ├── drive
│   ├── gmail
│   ├── market
│   └── news
└── mcp

跑

./gradlew bootRun

k6回归测试

使用k6脚本在所有当前公开的MCP工具和资源端点上运行轻量级回归扫描。

# start app
./gradlew bootRun

# in another terminal
k6 run perf/mcp-regression.k6.js

# optional overrides
BASE_URL=http://localhost:8080 VUS=2 ITERATIONS=5 k6 run perf/mcp-regression.k6.js

# helper wrapper (writes logs to perf/results/)
./perf/run-k6-regression.sh

最新运行输出记录在 perf/results/k6-regression-run.log，JSON摘要写入 perf/results/mcp-regression-summary.json，并在以下位置生成可读的动态HTML报告 perf/results/mcp-regression-report.html 直接通过k6(handleSummary).

该脚本验证：

工具端点： drive.search_files, gmail.search_messages, news.search_articles, market.quote
资源终结点： /mcp/resources/news/sources, /mcp/resources/system/provider-health

示例通话

curl -X POST http://localhost:8080/mcp/tools/market.quote \
  -H 'content-type: application/json' \
  -d '{"symbol":"AAPL"}'

curl http://localhost:8080/mcp/resources/news/sources

Kotlin/Spring启动器的实现 单数据访问MCP服务器 使用精简的MCP工具处理程序和可插拔的域适配器。

架构（4层）

MCP层

域适配器

- GoogleDriveAdapter - GmailAdapter - NewsAdapter - MarketDataAdapter

认证层

- 访问上下文和令牌存储抽象。

缓存/事件层

- 缓存服务抽象（MVP的内存实现）。

实施计划

第一阶段（已实施）

Bootstrap Kotlin+Spring Boot应用程序。
添加规范化域模型：

- DriveFile, MailMessage, Article, Quote.

为以下对象添加工具合同和处理程序：

- drive.search_files - gmail.search_messages - news.search_articles - market.quote

添加适配器接口和存根实现。
为报价响应添加短期缓存。
添加基本集成测试 market.quote.

第二阶段（下）

添加 drive.read_file_text, gmail.get_thread, market.quotes_batch, news.get_topic_digest.
添加分页标记持久性和更强的结果新鲜度元数据。
添加Redis支持的缓存实现。

第三阶段（下一阶段）

驱动器/Gmail手表集成。
市场WebSocket流消费者。
提供程序路由+故障转移策略。
源注册表持久化和项目删除管道。

封装结构

src/main/kotlin/com/example/mcp
├── auth
├── cache
├── domain
│   ├── drive
│   ├── gmail
│   ├── market
│   └── news
└── mcp

Gmail真实-API模式

默认情况下，Gmail使用存根适配器。要连接到实时Gmail数据，请启用Gmail集成并提供OAuth承载令牌：

integrations:
  gmail:
    enabled: true
    base-url: https://gmail.googleapis.com/gmail/v1
    user-id: me
    access-token: ${GMAIL_ACCESS_TOKEN}

当启用时， gmail.search_messages 电话：

GET /users/{userId}/messages
GET /users/{userId}/messages/{messageId}?format=metadata

并将结果标准化为 MailMessage.

新闻多源real-API模式

默认情况下，News使用存根适配器。要在单个请求中聚合多个实时源，请启用新闻集成并配置 integrations.news.sources.

integrations:
  news:
    enabled: true
    sources:
      - id: pinterest
        url: https://www.pinterest.com/news.rss
        type: RSS
        auth: NONE
      - id: toi
        url: https://timesofindia.indiatimes.com/rssfeedstopstories.cms
        type: RSS
        auth: NONE
      - id: github
        url: https://api.github.com/repos/spring-projects/spring-boot/issues
        type: JSON
        auth: HEADER
        auth-header: Authorization
        auth-token: ${GITHUB_TOKEN}
        query-param: q

news.search_articles 然后可以跨所有启用的源（或通过以下方式查询子集 sources[] 在工具输入中）在一个请求中。

跑

./gradlew bootRun

示例通话

curl -X POST http://localhost:8080/mcp/tools/market.quote \
  -H 'content-type: application/json' \
  -d '{"symbol":"AAPL"}'

curl http://localhost:8080/mcp/resources/news/sources

容器映像和Kubernetes自动缩放

为应用程序构建一个容器映像：

docker build -t mcp-server-generic:latest .

部署到启用HPA的Kubernetes：

kubectl apply -f k8s/deployment.yaml
kubectl apply -f k8s/service.yaml
kubectl apply -f k8s/hpa.yaml

检查卷展栏和自动缩放器状态：

kubectl rollout status deployment/mcp-server-generic
kubectl get hpa mcp-server-generic

工具与能力

工具数量

资源数量

提示词数量

能力标签

Kotlin本地部署数据集成多源查询微服务SpringBoot

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

看服务状态

查询容器、日志和监控指标，定位异常。

执行部署变更

在权限范围内触发发布、回滚和环境切换。

核对资源用量

汇总用量，找出闲置和超额的部分。

选择建议

值得选的地方

只提供 4 个工具，职责集中，接入后不容易误操作。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

公开资料没有可直接复制的安装命令，第一次接入要自己找入口。
需要自备OAuth 授权，没有凭据没法直接试。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在运维云端场景里让模型直接调用外部能力的人。
愿意照着官方文档一步步配环境的人。

不太适合

暂时拿不到OAuth 授权的人。
希望一条命令就装好、不想看文档的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
MCP Server Generic MCP World · 本页	4	未说明	未标注	1 个	2026-05-17
Ui Tars Desktop 8a825770 MCP World	0	stdio	有	1 个	2026-05-17
Elie222 MCP MCP World	0	未说明	未标注	1 个	2026-05-17
Arizeai Phoenix MCP MCP World	0	stdio	有	3 个	2026-05-17
Unity MCP 87ee506e MCP World	42	HTTP	有	2 个	2026-05-17

常见问题

5 条