MCP Server

MCP Server 是一个基于 Go 语言的 MCP 工具项目，提供一系列 MCP 实用工具。 这是一个个人学习项目，请勿在生产环境中使用。 使用 github.com/ThinkInAIXYZ/go-mcp 作为 MCP 核心框架。

功能特性

• IP 地址处理服务
• 时间服务
• 海报生成服务
• 更多功能即将推出...

系统要求

• Go 1.23.0 或更高版本
• 支持 Linux、macOS 和 Windows

快速开始

安装

# 克隆项目
git clone https://github.com/luffy050596/mcp-server.git
cd mcp-server

# 安装依赖
go mod download

构建

构建单个服务：

make build dir=<服务目录>

构建所有服务：

make build-all

测试

运行所有测试：

make test

运行

运行单个服务：

./bin/mcp-ip -mode=stdio -addr=:59001

参数

• -mode 运行模式，可选值为 stdio 或 sse。 默认为 stdio
• -addr 服务地址，当 -mode=sse 时为必填项
• -key 百炼 API 密钥，海报服务需要

项目结构

.
├── bin/           # 编译后的二进制文件
├── ip/            # IP 地理位置信息，使用 https://ip.rpcx.io API
├── time/          # 时间查询和时间戳转换
├── poster/        # 海报生成服务，使用百炼创意海报生成 API (https://help.aliyun.com/zh/model-studio/creative-poster-generation)
└── pkg/           # 共享包

开发工具

本项目使用以下开发工具来确保代码质量：

• .golangci.yaml - golangci-lint 配置
• .pre-commit-config.yaml - Git pre-commit 钩子
• .gitleaks.toml - Gitleaks 敏感信息检测配置

依赖管理

主要依赖：

• github.com/ThinkInAIXYZ/go-mcp - MCP 核心库

贡献

1. Fork 仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

许可证

本项目使用 LICENSE 文件中规定的条款进行许可 - 有关详细信息，请参阅 LICENSE 文件。

联系方式

• 项目维护者: [您的名字]
• 项目链接: https://github.com/luffy050596/mcp-server

鸣谢

感谢所有为本项目做出贡献的开发者。