MCP Server

MCP Server

MCP Server は、さまざまな MCP ユーティリティを提供する Go ベースの MCP ツールプロジェクトです。 個人的な学習プロジェクトのため、本番環境では使用しないでください。 MCP コアフレームワークとして github.com/ThinkInAIXYZ/go-mcp を使用しています。

機能

• IP アドレス処理サービス
• 時刻サービス
• ポスター生成サービス
• 今後、さらに機能を追加予定です...

システム要件

• Go 1.23.0 以降
• Linux、macOS、Windows に対応

クイックスタート

インストール

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

# Install dependencies
go mod download

ビルド

単一のサービスをビルドします：

make build dir=<service_directory>

すべてのサービスをビルドします：

make build-all

テスト

すべてのテストを実行します：

make test

実行

単一のサービスを実行します：

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

パラメーター

• -mode 実行モードです。指定可能な値は stdio または sse です。デフォルトは stdio です
• -addr サービスアドレスです。-mode=sse の場合に必須です
• -key Bailian API Key です。ポスターサービスで必須です

プロジェクト構成

.
├── 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

開発ツール

コード品質を確保するため、プロジェクトでは以下の開発ツールを使用しています：

• .golangci.yaml - golangci-lint の設定
• .pre-commit-config.yaml - Git の pre-commit フック
• .gitleaks.toml - Gitleaks による機密情報検出の設定

依存関係の管理

主な依存関係：

• github.com/ThinkInAIXYZ/go-mcp - MCP コアライブラリ

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. Pull Request を作成します

ライセンス

このプロジェクトは LICENSE ファイルの条件に基づいてライセンスされています。詳細は LICENSE ファイルをご覧ください。

お問い合わせ

• プロジェクトメンテナー：[Your Name]
• プロジェクトリンク：https://github.com/luffy050596/mcp-server

謝辞

このプロジェクトに貢献してくださったすべての開発者に感謝します。