Shioaji-MCP

end2end-mcp

一个端到端示例，展示如何构建 Model Context Protocol (MCP) 客户端，并通过兼容 OpenAI 的 API 与多个 MCP 服务通信。

简而言之

只需运行一条简单的命令，就可以像在 Claude Desktop App 中一样运行 MCP 服务：

uv run python client/client.py

前置条件

1. 确保已安装 uv。

uv venv

source .venv/bin/activate

uv sync

简介

示例 MCP 服务

1. Shioaji：一个使用 Shioaji API 提供基本股票交易功能的示例 MCP 服务。要正确使用它，还需要进一步配置。
2. Weather：一个来自 MCP 官方文档的简单示例。

MCP 主机

我没有使用 Claude API，而是将其替换为兼容 OpenAI 的 API，支持两个主要的大模型提供商：

1. OpenAI
2. Ollama

你可以通过修改 LLM_PROVIDER 环境变量在它们之间切换。

连接 MCP 主机

选择大模型提供商后，你可以通过修改 config.json 文件，将服务连接到 MCP 主机，如下例所示：

{
  "mcpServers": {
    "weather": {
      "args": [
        "--directory",
        "root_path",
        "run",
        "server_file.py"
      ],
      "command": "uv_exec_command"
    }
  }
}

运行 MCP 主机

你可以使用以下命令运行 MCP 主机：

uv run python client/client.py

使用完 MCP 主机后，只需输入 exit 即可退出。

server/ 中的 shioaji-server 已通过 MCP Review 认证。MCP Review 链接