Mcp4go

🚀 MCP4Go 日本語ドキュメント

MCP4Go は、モデルコンテキストプロトコル (MCP) の純粋な Go 言語による実装です。AI アプリケーションの開発を、プロトコルの複雑さを抽象化することで簡素化することを目的としています。

✨ 主な機能

• 純粋な Go 言語で実装された完全な MCP プロトコル
• 一般的な MCP リソースの高レベル抽象化を提供
• カスタム拡張をサポートする拡張可能なアーキテクチャ
• 詳細なドキュメントとサンプル
• 堅牢なエラー処理を備えた本番環境対応

📦 インストール

MCP4Go は Go 1.18 以上が必要です。Go モジュールを使用してインストールします。

go get github.com/mcp4go/mcp4go

🚀 クイックスタート

MCP4Go を使い始めるには、Go アプリケーションにパッケージをインポートします。

基本的な使用法

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"os/signal"
	"syscall"
	"time"

	"github.com/mcp4go/mcp4go/pkg/logger"
	"github.com/mcp4go/mcp4go/protocol"
	"github.com/mcp4go/mcp4go/server"
	"github.com/mcp4go/mcp4go/server/iface"
	"github.com/mcp4go/mcp4go/server/transport"

	_ "time/tzdata" // 加载所有时区
)

func main() {
	ctx, cancel := context.WithCancel(context.Background())
	defer cancel()
	_logger := logger.DefaultLog

	// 监听中断信号以实现优雅关闭
	signalCh := make(chan os.Signal, 1)
	signal.Notify(signalCh, os.Interrupt, syscall.SIGTERM)
	go func() {
		<-signalCh
		_logger.Logf(ctx, logger.LevelWarn, "接收到了关闭信号")
		cancel()
	}()

	type timeRequest struct {
		TimeZone string `json:"time_zone,omitempty" description:"时区，默认为 Asia/Shanghai"`
	}

	// 创建标准输入输出传输层
	stdioTransport := transport.NewDefault()

	// 创建服务器实例
	srv, err := server.NewServer(server.WithLogger(_logger),
		server.WithTransport(stdioTransport),
		server.WithToolDefinitions(func() *iface.ToolDefinitions {
			td := iface.NewToolDefinitions()
			promptTemplate := `{{.ToolPrefix}}: {{.Name}}{{if .Version}}-v{{.Version}}{{end}}：{{.Description}}`

			toolDef := td.Add("time", "获取当前时间", "返回指定时区的当前时间")
			toolDef.AddParameter("timeZone", &iface.ToolParameter{
				Type:        "string",
				Description: "目标时区，例如 'Asia/Shanghai' 或 'UTC'",
				Default:     "Asia/Shanghai",
			})

			return td
		}()),
	)
	if err != nil {
		log.Printf("Failed to create server: %v\n", err)
		return
	}
	defer srv.Close()

	// 启动服务器
	_logger.Logf(ctx, logger.LevelWarn, "启动 Time MCP 服务器")
	if err := srv.Run(ctx); err != nil {
		_logger.Logf(ctx, logger.LevelError, "服务器错误: %v", err)
		return
	}

	_logger.Logf(ctx, logger.LevelWarn, "服务器关闭完成")
}

📚 ドキュメント

MCP4Go は完全なモデルコンテキストプロトコルの実装を提供し、以下の機能をサポートしています。

• JSON-RPC 通信
• リソースのライフサイクル管理
• プロンプトエンジニアリング
• ツールの定義と呼び出し
• サンプリングパラメータの設定
• ログ記録と診断

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。

🔗 貢献方法

貢献を歓迎します！詳細については CONTRIBUTING.md を参照してください。