# Ai Mcp

> 基于 Go 的 MCP 服务端，支持 SSE、受控命令执行、SQL/查询工具、时间工具，集成 GoFrame/MySQL，适配 IDE/Agent 即用。

- **Type:** MCP server
- **Install:** `agentstack add mcp-xgd16-ai-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xgd16](https://agentstack.voostack.com/s/xgd16)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [xgd16](https://github.com/xgd16)
- **Source:** https://github.com/xgd16/ai-mcp
- **Website:** https://github.com/xgd16/ai-mcp

## Install

```sh
agentstack add mcp-xgd16-ai-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ai-mcp

🚀 **轻量级、高性能的 MCP（Model Context Protocol）服务端**

一个用 Go 构建的 MCP 服务端，基于 `mark3labs/mcp-go` 与 GoFrame v2。项目内置多种可即用的工具（Tools），可通过 MCP 客户端（如 Cursor、继续集成的 IDE/Agent）进行调用。

✨ **核心优势**
- 🪶 **轻量级**：单文件部署，无复杂依赖
- 🌍 **多平台支持**：支持 Windows、macOS、Linux 等主流操作系统
- 💾 **低内存占用**：运行时内存占用  提示：仓库默认配置包含示例数据库连接，请替换为你自己的连接信息，避免敏感信息泄露。

4) 运行
```bash
./mcp-server
```
启动后，终端会打印：
```
MCP SSE服务已启动地址: http://127.0.0.1:18232/sse
```

5) 连接到 MCP 客户端
在支持 MCP 的客户端中新增一个服务端配置，指向上述 SSE 地址（例如 `http://127.0.0.1:18232/sse`）。不同客户端配置方式略有差异，请参考对应客户端文档。

## 内置工具（Tools）
以下工具名称与参数定义自 `internal/mcp/handler.go` 注册，处理函数位于对应 `mcp_tool_*.go` 文件：

- `RunSafeShellCommand`：安全执行终端命令（禁用危险操作符、限制超时与管道数）。
  - 参数：
    - `command`(必填)：命令文本，最多 3 个 `|` 管道，禁止 `&&`/`||`/重定向等；
    - `timeoutSeconds`(可选)：超时秒，默认 10，最大 60；
    - `cwd`(可选)：工作目录。

- `Md5Encode`：对给定文本进行 MD5（小写十六进制）。
  - 参数：`text`(必填)

- `Base64Encode`：文本转 Base64。
  - 参数：`text`(必填)

- `Base64Decode`：Base64 解码为文本。
  - 参数：`data`(必填)

- `JwtParse`：解析 JWT（不校验签名），返回 header 与 payload。
  - 参数：`token`(必填)

- `JsonEncode`：校验并压缩 JSON 字符串。
  - 参数：`raw`(必填)

- `SQL_Actuator`：把自然语言转 SQL 的上层调用者可将 SQL 传入本工具执行，结果以 Markdown 表格返回。
  - 参数：`sql`(必填)

- `GetDatabaseInfo`：返回数据库类型、主机、端口、库名、用户名、版本、大小等信息。
  - 参数：`dbname`(可选)

- `NowTime`：获取当前时间信息与毫秒时间戳。

- `TimestampToDateTime`：将时间戳转换为日期时间字符串。
  - 参数：`timestamp`(必填)

- `GetCalendarDays`：获取指定年与月的所有日期信息（是否周末、英文月名等）。
  - 参数：`year`、`month`(必填)

## 日志
- 日志配置位于 `config.yaml` 的 `logger` 段；
- 当 `path` 配置为目录时，会按 `file` 模板写日志；
- `stdout: true` 时会同时输出到终端。

## 开发说明

### 🏗️ 项目架构
- **模块名**：`ai-mcp`（见 `go.mod`）
- **主要依赖**：
  - `github.com/mark3labs/mcp-go`（MCP 协议实现）
  - `github.com/gogf/gf/v2`（配置、日志、时间、数据库等）
- **入口**：`main.go`，启动 SSE 服务，地址来自 `config.yaml` 的 `mcp-server.address`
- **工具注册**：`internal/mcp/handler.go` 遍历 `GetList()` 注册 Tools

### ⚡ 轻量级构建优化
- **绿色 GC**：使用 `GOEXPERIMENT=greenteagc` 启用 Go 实验性垃圾回收器，减少内存占用
- **二进制瘦身**：使用 `-ldflags="-s -w"` 去除调试信息和符号表，减小文件体积
- **静态链接**：生成静态链接的可执行文件，无需外部依赖
- **交叉编译**：支持一键构建多平台版本，满足不同部署需求

## 常见问题

### 🔧 部署相关问题
- **端口被占用**：修改 `config.yaml` 中的 `mcp-server.address`
- **无法连接数据库**：确认 `database.default.link` 正确、网络可达，必要时关闭或放通防火墙
- **客户端连不上**：确保使用 SSE 地址（形如 `http://host:port/sse`）

### 🚀 性能优化问题
- **内存占用过高**：确保使用 `GOEXPERIMENT=greenteagc` 构建，启用绿色 GC 优化
- **启动速度慢**：检查系统资源，程序冷启动时间通常 < 100ms
- **跨平台兼容性**：使用 `make build-all` 构建所有平台版本，确保目标平台支持
- **文件体积大**：使用 `-ldflags="-s -w"` 参数去除调试信息，可减小 30-50% 体积

## 许可协议
MIT License

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xgd16](https://github.com/xgd16)
- **Source:** [xgd16/ai-mcp](https://github.com/xgd16/ai-mcp)
- **License:** MIT
- **Homepage:** https://github.com/xgd16/ai-mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-xgd16-ai-mcp
- Seller: https://agentstack.voostack.com/s/xgd16
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.