About MCP Server
A Go-based MCP utilities project for developers, with services for IP address processing, time queries, and poster generation. It is presented as a personal learning project and is not intended for production use.
Key features
- 01IP address processing
- 02Time queries and timestamp conversion
- 03Poster generation service
- 04stdio and SSE modes
Use cases
- 01Look up IP geolocation information
- 02Retrieve times and convert timestamps
- 03Generate creative posters
MCP support
Built on github.com/ThinkInAIXYZ/go-mcp, it exposes IP, time, and poster utilities as MCP services.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMCP Server
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
-modeRunning mode, available values arestdioorsse. Default isstdio-addrService address, required when-mode=sse-keyBailian 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
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
This project is licensed under the terms of the LICENSE file - see the LICENSE file for details.
Contact
- Project Maintainer: [Your Name]
- Project Link: https://github.com/luffy050596/mcp-server
Acknowledgments
Thanks to all developers who have contributed to this project.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.