MCP Server · 数据服务

Mcpserverkotlin

一个基于Kotlin实现的MCP全栈服务器，使AI代理能够自主构建和管理应用程序。

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

Kotlin数据库连接Docker知识图谱

快速开始

打开主来源页面 GitHub 仓库

作者 / 组织: apptolast
提供方: apptolast
运行时: Docker

工具数量

来源目录标注

资源数量

来源目录标注

提示词数量

来源目录标注

GitHub Star

仓库热度

收录来源

1 个

MCP World

选型结论

Mcpserverkotlin 属于数据服务类 MCP Server，公开资料标注 0 个工具，通过stdio 本地进程接入，客户端适配情况以官方文档为准，有可以直接复制的安装命令；接入前先确认权限范围。

分类

数据服务

传输方式

stdio

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

安装命令

docker run -p 3000:3000 mcp-fullstack-server

客户端配置示例

{
  "mcpServers": {
    "mcpserverkotlin": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "mcp-fullstack-server"
      ]
    }
  }
}

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Docker，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 0 个工具，随便调一个只读工具确认能返回结果。

接入前确认

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

详细介绍

MCP全栈服务器

用Kotlin实现的MCP（模型上下文协议）全栈服务器，使AI代理能够自主构建和管理应用程序。

概述

该服务器实现了MCP协议，为AI代理提供了强大的功能：

文件系统操作：安全的文件读取、写入和目录管理
Bash执行：通过白名单和验证安全执行命令
GitHub集成：版本控制操作（git命令）
知识图谱记忆：用于AI上下文的持久存储系统
数据库连接器：PostgreSQL、MongoDB和MySQL集成
资源管理：自定义文档和资源处理

特性

✅ 安全第一

路径遍历保护
命令白名单
文件大小和扩展名验证
危险模式检测

✅ Kubernetes就绪

Docker支持
包括Kubernetes清单
健康检查和准备情况调查
资源限制和请求

✅ 可观察对象

结构化日志记录
健康和准备终点
指标支持（计划中）

✅ CI/CD就绪

使用GitHub Actions自动构建Docker
Docker Hub集成
多分支部署支持（主/开发）
Kubernetes部署自动化

快速开始

先决条件

JDK 21+
Gradle 8.10+
Kotlin 2.2.0+

建筑

./gradlew build

跑步

./gradlew run

或者使用自定义配置：

export MCP_HOST=0.0.0.0
export MCP_PORT=3000
export MCP_WORKING_DIR=/workspace
./gradlew run

使用Docker运行

docker build -t mcp-fullstack-server -f docker/Dockerfile .
docker run -p 3000:3000 mcp-fullstack-server

测试

运行测试

# Run all tests
./gradlew test

# Run specific test class
./gradlew test --tests "BashExecutorTest"

# Run with coverage report
./gradlew test jacocoTestReport

测试覆盖率

总测试：57项测试（53项有效，4项暂时禁用）
通过率：100%的主动测试（53/53通过）；4项测试暂时禁用
按模块覆盖:

- 文件系统：100% - Bash：100% - GitHub：100% - 资源：100% - PostgreSQL：100% - MongoDB：100% - 内存：71%（由于JSONL序列化问题，2个测试被禁用）

有关详细的测试说明，请参阅测试指南.md.

配置

服务器通过以下方式配置 src/main/resources/application.conf。您可以使用环境变量覆盖设置：

服务器配置

MCP_HOST：服务器主机（默认值：0.0.0.0）
MCP_PORT：服务器端口（默认值：3000）

文件系统配置

MCP_ALLOWED_DIRS：逗号分隔的允许目录列表
MCP_MAX_FILE_SIZE：最大文件大小（以字节为单位）（默认值：10MB）

Bash配置

MCP_ALLOWED_COMMANDS：逗号分隔的允许命令列表
MCP_WORKING_DIR：bash命令的工作目录
MCP_COMMAND_TIMEOUT：命令超时（秒）（默认值：300）

GitHub配置

MCP_REPO_PATH：git存储库的路径
GITHUB_TOKEN：GitHub个人访问令牌

数据库配置

POSTGRES_HOST, POSTGRES_PORT, POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD
MONGODB_CONNECTION_STRING, MONGODB_DB

内存配置

MCP_MEMORY_PATH：知识图存储路径

项目结构

mcp-fullstack-server/
├── src/main/kotlin/com/apptolast/mcp/
│   ├── Application.kt              # Main application entry point
│   ├── server/
│   │   └── ServerConfig.kt         # Configuration management
│   ├── modules/
│   │   ├── filesystem/             # Filesystem operations
│   │   ├── bash/                   # Bash command execution
│   │   ├── github/                 # Git/GitHub integration
│   │   ├── memory/                 # Knowledge graph memory
│   │   ├── database/               # Database connectors
│   │   └── resources/              # Resource management
│   ├── transport/                  # MCP transport layers
│   ├── security/                   # Security validation
│   └── util/                       # Utilities and protocol definitions
├── src/main/resources/
│   ├── application.conf            # Application configuration
│   └── logback.xml                 # Logging configuration
├── docker/
│   └── Dockerfile                  # Docker image definition
└── k8s/                           # Kubernetes manifests

API终点

健康和状态

GET /：服务器信息
GET /health：健康检查
GET /ready：准备状态检查
GET /info：服务器功能和版本

模块

文件系统模块

通过以下方式提供安全的文件系统操作：

路径验证和遍历保护
文件大小限制
扩展白名单
读取、写入、列出、创建和删除操作

Bash执行器模块

通过以下方式安全执行命令：

命令白名单
危险模式检测
超时保护
工作目录隔离

内存模块

持久AI记忆的知识图：

实体创建和存储
关系管理
图搜索和遍历
基于JSONL的存储

安全

服务器实现了多个安全层：

路径验证：所有文件系统操作都会根据允许的目录验证路径
命令白名单：只能执行明确允许的命令
危险模式检测：阻止已知的危险命令模式
文件大小限制：防止大文件操作
扩展过滤：只能访问允许的文件扩展名
超时保护：命令有执行时间限制

发展

运行测试

./gradlew test

代码风格

这个项目遵循Kotlin编码规范。格式化代码：

./gradlew ktlintFormat

部署

码头工人

该项目包括带有GitHub Actions的自动化CI/CD：

# Automated deployment (triggered on push to main/develop)
git push origin main

看 .github/QUICKSTART.md 获取完整的CI/CD文档。

手动Docker构建

docker build -t mcp-fullstack-server -f docker/Dockerfile .
docker run -p 3000:3000 mcp-fullstack-server

Kubernetes

应用Kubernetes清单：

kubectl apply -f k8s/

这将创建：

使用MCP服务器进行部署
内部/外部访问服务
用于配置的ConfigMap
敏感数据的秘密
持久卷数据存储索赔

有关CI/CD构建后的Kubernetes自动更新，请参阅 .github/workflows/README.md.

许可证

有关详细信息，请参阅LICENSE文件。

贡献

欢迎投稿！拜托：

分叉存储库
创建要素分支
进行更改
添加测试
提交拉取请求

支持

对于问题和疑问：

在GitHub上创建问题
检查技术规范文件

路线图

完整的实施路线图见技术规范文件，包括：

第一阶段：基础（文件系统、Bash）
第二阶段：Git和内存集成
第3阶段：数据库连接器
第四阶段：集装箱化和K8s
第5阶段：可观察性和测试
第6阶段：硬化和生产

技术规范

有关详细的技术信息、体系结构和实现细节，请参阅 McpServerTecnicalDocument.txt.

工具与能力

工具数量

资源数量

提示词数量

能力标签

Kotlin本地部署AI代理文件系统操作Bash执行GitHub集成知识图谱数据库连接

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

典型使用场景

用自然语言查库

不用手写 SQL，直接问数据，让模型组织查询语句。

数据巡检

定期拉指标、做对比，把异常项整理成一段说明。

打通业务数据

把数据库、数仓和接口接进同一个上下文，减少导出再上传。

选择建议

值得选的地方

只提供 0 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

stdio 方式要求本地装好 Docker，换机器要重新装一遍。
公开摘要偏短，具体能力和限制要回到仓库确认。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在数据服务场景里让模型直接调用外部能力的人。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Mcpserverkotlin MCP World · 本页	0	stdio	有	1 个	2026-05-17
Memory 9d25f64e MCP World	9	未说明	未标注	1 个	2026-05-17
Prisma MCP Server MCP World	0	stdio	有	3 个	2026-05-17
Astr Bot MCP World	0	stdio	有	1 个	2026-05-17
Getzep MCP MCP World	9	stdio	有	1 个	2026-05-17

常见问题

5 条