Inori MCP

🚀 一個非常簡單的 MCP 服務器

本項目分別運用 Go 和 Python 實現了一個極為簡單的 MCP 服務器，同時搭配一個 MCP 客戶端進行調用。該項目不依賴任何外部 API，能讓你輕鬆理解簡單的 MCP 工作流。

🚀 快速開始

情景假設

書架編號為 A、B、C、D，共 4 個架子存放著書籍。我們需要藉助大模型查找對應編號的書架中的書籍。

實現文件

• bookSearch.go：MCP 工具的 Go 實現。
• MCPServer_book_search.py：MCP 工具的 Python 實現。
• README.md：Python 工作流說明。

編寫方法

規定 MCP 的入參

type BookShelfParams struct {
    BookShelfId string `json:"book_shelf_id" jsonschema:"required,description=The ID of the book shelf"`
}

核心邏輯

func bookSearchHandler(ctx context.Context, args BookShelfParams) (*mcp.CallToolResult, error) {
    // 邏輯實現，可以替換成任何外部 API 調用
    return mcp.NewToolResultText("返回結果:xxxx"), nil
}

定義工具名稱和說明

var BookSearchTool = InoriMCP.MustTool(
    "book-search",
    "圖書搜索工具",
    bookSearchHandler,
)

入口函數

func AddBookSearchTools(mcp *server.MCPServer) {
    BookSearchTool.Register(mcp)
}

在 main.go 中加入這個工具：

tools.AddBookSearchTools(s)

構建命令

go build -o inori-mcp.exe ./cmd/inori-mcp

啟動 MCP 服務器

mcp.exe

需要注意的是，Go 和 Python 的 MCP 客戶端啟動方式有所不同。

調試

安裝 Node 環境，使用 inspector 工具，先連接到 MCP 服務器，然後輸入 A、B、C、D 查看是否返回書架中的書籍信息。

npx -y @modelcontextprotocol/inspector .\inori-mcp.exe

啟動 Client 與 MCP 聯動

修改 MCPClient.py 中第 51 行的 connect_to_server 函數的啟動腳本：

server_params = StdioServerParameters(
    command=<mcp.exe> 的路徑,
    args=[],
    env=None
)

需要從 .env.sample 中創建 .env 文件，填入 OpenAI 兼容的大模型的基礎 URL，並建議使用 QWQ-32B 模型（不推薦 DeepSeek 系列）。模型需要觸發 ToolCall 並總結結果，最終返回書架中的書籍信息。