mcpserver.so LogoMCPFly
Submit
MCP Server logo

MCP Server

by luffy050596

UtilitiesGoUtilitiesIP Address ProcessingTime ServicePoster Generation

MCP Server is a Go-based project providing MCP utilities, built as a personal learning project. It utilizes github.com/ThinkInAIXYZ/go-mcp as its core framework.

View on GitHub

Last updated: N/A

MCP Server

Go Report Card

Go Report Card

GoDoc

GoDoc
License

License

MCP Server is a Go-based MCP tools project that provides a series of MCP utilities. This is a personal learning project, please do not use it in production environment. Using github.com/ThinkInAIXYZ/go-mcp as the MCP core framework.

Features

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

System Requirements

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

Quick Start

Installation

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

# Install 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 Bailian API Key, required for poster service

Project Structure

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

Development Tools

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

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

Dependency Management

Main dependencies:

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

Contributing

  1. Fork the repository
  2. Create your 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 of the LICENSE file - see the LICENSE file for details.

Contact

Acknowledgments

Thanks to all developers who have contributed to this project.