MCP Go

🚀 mcp - go

mcp - go 是一個功能強大的 Go 庫，用於實現與 Mark3 Labs 的 MCP 標準兼容的服務器。它為構建智能代理和 AI 驅動的應用程序提供核心功能，涵蓋工具管理、資源提供和會話處理等方面。

🚀 快速開始

要快速入門 mcp - go，可參考以下步驟：

1. 安裝：

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

2. 創建服務器實例：

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

3. 添加工具：

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

4. 啟動服務器：

   s.ListenAndServe(":8080")
   

更多詳細信息請參考[快速入門](https://github.com/mark3labs/mcp - go/blob/main/docs/zh_cn/getting_started.md)文檔。

✨ 主要特性

• 工具管理：支持添加、刪除和管理自定義工具。工具可以是任何能夠處理請求並返回結果的函數。
  • 示例：添加工具

  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) {
      // 處理文件請求
  }))
  

• 會話支持：基於上下文的會話管理，確保不同用戶之間的數據隔離。
  • 示例：獲取當前會話

  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)
    }
}

📚 詳細文檔

• English：
  • [Getting Started](https://github.com/mark3labs/mcp - go/blob/main/docs/en - us/getting_started.md)
  • [API Reference](https://github.com/mark3labs/mcp - go/blob/main/docs/en - us/api_reference.md)
  • [Tool Management](https://github.com/mark3labs/mcp - go/blob/main/docs/en - us/tool_management.md)
  • [Resource Management](https://github.com/mark3labs/mcp - go/blob/main/docs/en - us/resource_management.md)
• 中文：
  • [快速入門](https://github.com/mark3labs/mcp - go/blob/main/docs/zh_cn/getting_started.md)
  • [API 參考](https://github.com/mark3labs/mcp - go/blob/main/docs/zh_cn/api_reference.md)
  • [工具管理](https://github.com/mark3labs/mcp - go/blob/main/docs/zh_cn/tool_management.md)
  • [資源管理](https://github.com/mark3labs/mcp - go/blob/main/docs/zh_cn/resource_management.md)

🤝 貢獻指南

歡迎任何貢獻！請參考[開發者指南](https://github.com/mark3labs/mcp - go/blob/main/CONTRIBUTING.md)瞭解如何參與。