MCP Server Fh7

🚀 MCP Server

An MCP tool project based on Go, offering a series of MCP utilities. This is a personal learning project, not recommended for production use.

🚀 Quick Start

📦 Installation

# Clone the project
git clone https://github.com/luffy050596/mcp-server.git
cd mcp-server

# Download dependencies
go mod download

🏗️ Build

Build a single service:

make build dir=<service_directory>

Build all services:

make build-all

🧪 Test

Run all tests:

make test

▶️ Run

Run a single service:

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

Parameters

• -mode Running mode, available values are stdio or sse. Default is stdio
• -addr Service address, required when -mode=sse
• -key Baiyan API Key, required for the poster service

✨ Features

• IP address processing service
• Time service
• Poster generation service
• More features are coming soon...

📋 System Requirements

• Go 1.23.0 or higher
• Supports Linux, macOS, and Windows

💻 Usage Examples

Basic Usage

# Run the IP service in stdio mode
./bin/mcp-ip -mode=stdio -addr=:59001

Advanced Usage

# Run the IP service in sse mode
./bin/mcp-ip -mode=sse -addr=:59001 -key=your_api_key

📚 Documentation

Project Structure

.
├── bin/           # Compiled binary files
├── ip/            # IP geographical location information, using https://ip.rpcx.io API
├── time/          # Time query and timestamp conversion
├── poster/        # Poster generation service, using Baiyan Creative Poster Generation API(https://help.aliyun.com/zh/model-studio/creative-poster-generation)
└── pkg/           # Shared packages

Development Tools

This project uses the following development tools to ensure code quality:

• .golangci.yaml - golangci-lint configuration
• .pre-commit-config.yaml - Git pre-commit hook
• .gitleaks.toml - Gitleaks sensitive information detection configuration

Dependency Management

Main dependencies:

• github.com/ThinkInAIXYZ/go-mcp - MCP core library

Contribution

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the terms in the LICENSE file.

• Project maintainer: [Your Name]
• Project link: https://github.com/luffy050596/mcp-server

Contact Information

• Maintainer name: [Your Name]
• Project link: https://github.com/luffy050596/mcp-server