MCP Go

🚀 mcp-go

mcp-go は強力な Go ライブラリで、Mark3 Labs の MCP 標準と互換性のあるサーバーを実装するために使用されます。このライブラリは、スマートエージェントや AI 駆動のアプリケーションを構築するために必要な核心機能を提供しており、ツール管理、リソース提供、セッション処理などが含まれます。

🚀 クイックスタート

mcp-go をすぐに使い始めるには、以下の手順に従ってください。

インストール

go get github.com/mark3labs/mcp-go/server

サーバーインスタンスの作成

s := server.NewMCPServer(
    server.WithName("My MCP Server"),
    server.WithVersion("1.0.0"),
)

ツールの追加

s.AddTool(mcp.NewTool("echo", func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    return mcp.NewToolResultText(req.Tool.Args[0]), nil
}))

サーバーの起動

s.ListenAndServe(":8080")

詳細情報については、クイックスタート ドキュメントを参照してください。

✨ 主な機能

ツール管理

mcp-go は強力なツール管理機能を提供しており、カスタムツールの追加、削除、管理を簡単に行うことができます。ツールは、リクエストを処理して結果を返すことができる任意の関数です。

ツール追加の例

s.AddTool(mcp.NewTool("echo", func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    return mcp.NewToolResultText(req.Tool.Args[0]), nil
}))

ツール削除の例

s.DeleteTool("echo")

リソース管理

Resource インターフェースを通じて、サーバーの機能を拡張し、ファイル、データベース、またはその他のサービスを処理することができます。

リソース追加の例

s.AddResource(mcp.NewResource("file", func(ctx context.Context, req mcp.CallResourceRequest) (*mcp.ResourceResult, error) {
    // ファイルリクエストを処理する
}))

セッションサポート

mcp-go はコンテキストベースのセッション管理を行い、異なるユーザー間のデータ隔離を保証します。

現在のセッションを取得する例

ctx := context.WithValue(context.Background(), server.SessionKey, "my-session-id")
s.ServeHTTP(ctx, w, r)

リクエストフック

リクエストのライフサイクルの重要なポイントにコールバックを追加し、モニタリングと可観測性を実現します。

フック追加の例

s.AddHook(server.HookTypeRequestStart, func(r *server.Server, ctx context.Context) {
    log.Println("Request started")
})

ツールハンドラーミドルウェア

ミドルウェアを通じて、ツール呼び出しの機能を拡張し、ログ記録、パフォーマンスモニタリングなどを行うことができます。

ミドルウェア追加の例

s.AddMiddleware(mcp.MiddlewareFunc(func(ctx context.Context, next mcp.ToolHandler) mcp.ToolHandler {
    return func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
        log.Println("Before processing tool")
        result, err := next(ctx, req)
        log.Println("After processing tool")
        return result, err
    }
}))

💻 使用例

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/mark3labs/mcp-go/server"
)

func main() {
    s := server.NewMCPServer(
        server.WithName("My MCP Server"),
        server.WithVersion("1.0.0"),
        server.WithTools(func(s *server.Server) {
            s.AddTool(mcp.NewTool("echo", func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
                return mcp.NewToolResultText(req.Tool.Args[0]), nil
            })
        }),
    )

    log.Println("Starting server on :8080...")
    if err := s.ListenAndServe(":8080"); err != nil {
        fmt.Printf("Server exited with error: %v\n", err)
    }
}

📚 ドキュメント

英語版

• Getting Started
• API Reference
• Tool Management
• Resource Management

中国語版

• クイックスタート
• API リファレンス
• ツール管理
• リソース管理

🤝 貢献ガイド

皆様からの貢献を歓迎します！貢献する方法については、開発者ガイド を参照してください。