提交qiming-mcp-proxy

2026-06-01 13:03:20 +08:00
parent 9e9486b7c2
commit afb3d9f4e6
394 changed files with 124494 additions and 0 deletions
--- a/qiming-mcp-proxy/Makefile
+++ b/qiming-mcp-proxy/Makefile
@@ -0,0 +1,357 @@
+# Makefile for cross-platform compilation of document-parser, voice-cli and mcp-proxy
+
+# 默认目标平台
+TARGET_PLATFORM ?= linux/amd64
+
+# Docker 镜像名称
+IMAGE_NAME = mcp-proxy-builder
+
+# 输出目录
+OUTPUT_DIR = ./dist
+
+# 通用构建函数
+define build_target
+	@echo "🚀 构建 $(1) $(2) 版本..."
+	@git pull
+	@mkdir -p $(3)
+	docker buildx build --platform $(4) --target export --output type=local,dest=$(3) -f docker/Dockerfile.document-parser ..
+	@echo "✅ $(1) $(2) 版本构建完成"
+endef
+
+# 默认目标
+.PHONY: all
+all: build-document-parser-x86_64
+
+# 创建输出目录
+$(OUTPUT_DIR):
+	@mkdir -p $(OUTPUT_DIR)
+
+# ============================================================================
+# Document Parser 构建目标
+# ============================================================================
+
+# 构建 document-parser Linux x86_64 版本
+.PHONY: build-document-parser-x86_64
+build-document-parser-x86_64:
+	$(call build_target,document-parser,Linux x86_64,./dist/document-parser-x86_64,linux/amd64)
+
+# 构建 document-parser Linux ARM64 版本
+.PHONY: build-document-parser-arm64
+build-document-parser-arm64:
+	$(call build_target,document-parser,Linux ARM64,./dist/document-parser-arm64,linux/arm64)
+
+# 构建 document-parser 多平台版本
+.PHONY: build-document-parser-multi
+build-document-parser-multi: build-document-parser-x86_64 build-document-parser-arm64
+
+# ============================================================================
+# Voice CLI 构建目标
+# ============================================================================
+
+# 构建 voice-cli Linux x86_64 版本
+.PHONY: build-voice-cli-x86_64
+build-voice-cli-x86_64:
+	$(call build_target,voice-cli,Linux x86_64,./dist/voice-cli-x86_64,linux/amd64)
+
+# 构建 voice-cli Linux ARM64 版本
+.PHONY: build-voice-cli-arm64
+build-voice-cli-arm64:
+	$(call build_target,voice-cli,Linux ARM64,./dist/voice-cli-arm64,linux/arm64)
+
+# 构建 voice-cli 多平台版本
+.PHONY: build-voice-cli-multi
+build-voice-cli-multi: build-voice-cli-x86_64 build-voice-cli-arm64
+
+# ============================================================================
+# MCP Proxy 构建目标
+# ============================================================================
+
+# 构建 mcp-proxy（按照当前系统架构）
+.PHONY: build-mcp-proxy
+build-mcp-proxy:
+	@echo "🚀 构建 mcp-proxy（当前系统架构）..."
+	@git pull
+	@mkdir -p ./dist/mcp-proxy
+	docker buildx build \
+		--target export \
+		--output type=local,dest=./dist/mcp-proxy \
+		-f docker/Dockerfile.mcp-proxy \
+		..
+	@echo "✅ mcp-proxy 构建完成"
+
+# ============================================================================
+# 所有组件构建目标
+# ============================================================================
+
+# 构建所有组件（当前系统架构）
+.PHONY: build-all
+build-all: build-document-parser-x86_64 build-voice-cli-x86_64 build-mcp-proxy
+
+# 构建 Docker 镜像（用于运行）
+.PHONY: build-image
+build-image:
+	@echo "🚀 构建 mcp-proxy Docker 运行镜像..."
+	docker buildx build \
+		--platform $(TARGET_PLATFORM) \
+		--target runtime \
+		-t mcp-proxy:latest \
+		-f docker/Dockerfile.mcp-proxy \
+		$(shell pwd)
+	@echo "✅ Docker 镜像构建完成: mcp-proxy:latest"
+
+# 构建 Docker 镜像（document-parser）
+.PHONY: build-image-document-parser
+build-image-document-parser:
+	@echo "🚀 构建 document-parser Docker 运行镜像..."
+	docker buildx build \
+		--platform $(TARGET_PLATFORM) \
+		--target runtime \
+		-t document-parser:latest \
+		-f docker/Dockerfile.document-parser \
+		..
+	@echo "✅ Docker 镜像构建完成: document-parser:latest"
+
+# 运行 Docker 镜像（mcp-proxy）
+.PHONY: run
+run: build-image
+	@echo "🚀 使用 docker-compose 后台启动 mcp-proxy..."
+	cd docker && docker-compose up -d
+	@echo "✅ mcp-proxy 已在后台启动"
+	@echo "📋 查看日志: cd docker && docker-compose logs -f"
+	@echo "🛑 停止服务: cd docker && docker-compose down"
+	@echo "📊 查看状态: cd docker && docker-compose ps"
+
+# 运行 Docker 镜像（mcp-proxy，前台模式）
+.PHONY: run-fg
+run-fg: build-image
+	@echo "🚀 使用 docker-compose 前台启动 mcp-proxy..."
+	cd docker && docker-compose up
+
+# 运行 Docker 镜像（document-parser）
+.PHONY: run-document-parser
+run-document-parser:
+	@echo "🚀 运行 document-parser..."
+	docker run --rm -p 8080:8080 document-parser:latest
+
+# 检查 Docker buildx 是否可用
+.PHONY: check-buildx
+check-buildx:
+	@echo "🔍 检查 Docker buildx 状态..."
+	@docker buildx version || (echo "❌ Docker buildx 不可用，请确保 Docker 版本支持 buildx" && exit 1)
+	@docker buildx ls
+	@echo "✅ Docker buildx 可用"
+
+# 创建 buildx builder（如果需要）
+.PHONY: setup-buildx
+setup-buildx:
+	@echo "🔧 设置 Docker buildx builder..."
+	docker buildx create --name cross-builder --use --bootstrap || true
+	@echo "✅ Docker buildx builder 设置完成"
+
+# ============================================================================
+# MCP 包发布目标
+# ============================================================================
+
+# 自动更新所有 MCP 包的版本号（小版本号加一）
+.PHONY: mcp-version-update
+mcp-version-update:
+	@echo "🔄 开始更新 MCP 包版本号..."
+	@echo ""
+	@# 读取 mcp-common 的当前版本
+	@COMMON_VERSION=$$(grep '^version = ' mcp-common/Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/'); \
+	COMMON_MAJOR=$$(echo $$COMMON_VERSION | cut -d. -f1); \
+	COMMON_MINOR=$$(echo $$COMMON_VERSION | cut -d. -f2); \
+	COMMON_PATCH=$$(echo $$COMMON_VERSION | cut -d. -f3); \
+	COMMON_NEW_PATCH=$$((COMMON_PATCH + 1)); \
+	COMMON_NEW_VERSION="$$COMMON_MAJOR.$$COMMON_MINOR.$$COMMON_NEW_PATCH"; \
+	echo "mcp-common: $$COMMON_VERSION -> $$COMMON_NEW_VERSION"; \
+	PROXY_VERSION=$$(grep '^version = ' mcp-proxy/Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/'); \
+	PROXY_MAJOR=$$(echo $$PROXY_VERSION | cut -d. -f1); \
+	PROXY_MINOR=$$(echo $$PROXY_VERSION | cut -d. -f2); \
+	PROXY_PATCH=$$(echo $$PROXY_VERSION | cut -d. -f3); \
+	PROXY_NEW_PATCH=$$((PROXY_PATCH + 1)); \
+	PROXY_NEW_VERSION="$$PROXY_MAJOR.$$PROXY_MINOR.$$PROXY_NEW_PATCH"; \
+	echo "mcp-stdio-proxy: $$PROXY_VERSION -> $$PROXY_NEW_VERSION"; \
+	echo ""; \
+	echo "1️⃣  更新 mcp-common 版本..."; \
+	sed -i.bak "s/^version = \"$$COMMON_VERSION\"/version = \"$$COMMON_NEW_VERSION\"/" mcp-common/Cargo.toml && rm mcp-common/Cargo.toml.bak; \
+	echo "2️⃣  更新 mcp-sse-proxy 版本和依赖..."; \
+	sed -i.bak "s/^version = \"$$COMMON_VERSION\"/version = \"$$COMMON_NEW_VERSION\"/" mcp-sse-proxy/Cargo.toml && rm mcp-sse-proxy/Cargo.toml.bak; \
+	sed -i.bak "s/mcp-common = { version = \"$$COMMON_VERSION\"/mcp-common = { version = \"$$COMMON_NEW_VERSION\"/" mcp-sse-proxy/Cargo.toml && rm mcp-sse-proxy/Cargo.toml.bak; \
+	echo "3️⃣  更新 mcp-streamable-proxy 版本和依赖..."; \
+	sed -i.bak "s/^version = \"$$COMMON_VERSION\"/version = \"$$COMMON_NEW_VERSION\"/" mcp-streamable-proxy/Cargo.toml && rm mcp-streamable-proxy/Cargo.toml.bak; \
+	sed -i.bak "s/mcp-common = { version = \"$$COMMON_VERSION\"/mcp-common = { version = \"$$COMMON_NEW_VERSION\"/" mcp-streamable-proxy/Cargo.toml && rm mcp-streamable-proxy/Cargo.toml.bak; \
+	echo "4️⃣  更新 mcp-stdio-proxy 版本和依赖..."; \
+	sed -i.bak "s/^version = \"$$PROXY_VERSION\"/version = \"$$PROXY_NEW_VERSION\"/" mcp-proxy/Cargo.toml && rm mcp-proxy/Cargo.toml.bak; \
+	sed -i.bak "s/mcp-common = { version = \"$$COMMON_VERSION\"/mcp-common = { version = \"$$COMMON_NEW_VERSION\"/" mcp-proxy/Cargo.toml && rm mcp-proxy/Cargo.toml.bak; \
+	sed -i.bak "s/mcp-streamable-proxy = { version = \"$$COMMON_VERSION\"/mcp-streamable-proxy = { version = \"$$COMMON_NEW_VERSION\"/" mcp-proxy/Cargo.toml && rm mcp-proxy/Cargo.toml.bak; \
+	sed -i.bak "s/mcp-sse-proxy = { version = \"$$COMMON_VERSION\"/mcp-sse-proxy = { version = \"$$COMMON_NEW_VERSION\"/" mcp-proxy/Cargo.toml && rm mcp-proxy/Cargo.toml.bak; \
+	echo ""; \
+	echo "✅ 版本号更新完成!"
+
+# 显示当前 MCP 包的版本号
+.PHONY: mcp-version-show
+mcp-version-show:
+	@echo "📋 当前 MCP 包版本号:"
+	@echo ""
+	@echo "  mcp-common:            $$(grep '^version = ' mcp-common/Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/')"
+	@echo "  mcp-sse-proxy:         $$(grep '^version = ' mcp-sse-proxy/Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/')"
+	@echo "  mcp-streamable-proxy:  $$(grep '^version = ' mcp-streamable-proxy/Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/')"
+	@echo "  mcp-stdio-proxy:       $$(grep '^version = ' mcp-proxy/Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/')"
+	@echo ""
+	@echo "📦 依赖版本号检查:"
+	@echo ""
+	@echo "  mcp-sse-proxy 依赖的 mcp-common:           $$(grep 'mcp-common = { version' mcp-sse-proxy/Cargo.toml | sed 's/.*version = "\([^"]*\)".*/\1/')"
+	@echo "  mcp-streamable-proxy 依赖的 mcp-common:    $$(grep 'mcp-common = { version' mcp-streamable-proxy/Cargo.toml | sed 's/.*version = "\([^"]*\)".*/\1/')"
+	@echo "  mcp-stdio-proxy 依赖的 mcp-common:         $$(grep 'mcp-common = { version' mcp-proxy/Cargo.toml | sed 's/.*version = "\([^"]*\)".*/\1/')"
+	@echo "  mcp-stdio-proxy 依赖的 mcp-sse-proxy:      $$(grep 'mcp-sse-proxy = { version' mcp-proxy/Cargo.toml | sed 's/.*version = "\([^"]*\)".*/\1/')"
+	@echo "  mcp-stdio-proxy 依赖的 mcp-streamable-proxy: $$(grep 'mcp-streamable-proxy = { version' mcp-proxy/Cargo.toml | sed 's/.*version = "\([^"]*\)".*/\1/')"
+
+# 发布所有 MCP 相关包（按依赖顺序）
+.PHONY: mcp-publish
+mcp-publish:
+	@echo "📦 开始发布 MCP 相关包到 crates.io..."
+	@echo ""
+	@echo "1️⃣  发布 mcp-common..."
+	cd mcp-common && cargo publish
+	@echo "⏳ 等待 10 秒让 crates.io 索引更新..."
+	@sleep 10
+	@echo ""
+	@echo "2️⃣  发布 mcp-sse-proxy..."
+	cd mcp-sse-proxy && cargo publish
+	@echo "⏳ 等待 10 秒让 crates.io 索引更新..."
+	@sleep 10
+	@echo ""
+	@echo "3️⃣  发布 mcp-streamable-proxy..."
+	cd mcp-streamable-proxy && cargo publish
+	@echo "⏳ 等待 10 秒让 crates.io 索引更新..."
+	@sleep 10
+	@echo ""
+	@echo "4️⃣  发布 mcp-stdio-proxy..."
+	cd mcp-proxy && cargo publish
+	@echo ""
+	@echo "✅ 所有 MCP 包发布成功！"
+
+# 预览将要发布的 MCP 包（dry-run）
+.PHONY: mcp-publish-dry-run
+mcp-publish-dry-run:
+	@echo "🔍 预览将要发布的 MCP 包..."
+	@echo ""
+	@echo "1️⃣  mcp-common:"
+	cd mcp-common && cargo publish --dry-run
+	@echo ""
+	@echo "2️⃣  mcp-sse-proxy:"
+	cd mcp-sse-proxy && cargo publish --dry-run
+	@echo ""
+	@echo "3️⃣  mcp-streamable-proxy:"
+	cd mcp-streamable-proxy && cargo publish --dry-run
+	@echo ""
+	@echo "4️⃣  mcp-stdio-proxy:"
+	cd mcp-proxy && cargo publish --dry-run
+	@echo ""
+	@echo "✅ 预览完成（未实际发布）"
+
+# 查看将要发布的文件列表
+.PHONY: mcp-package-list
+mcp-package-list:
+	@echo "📋 查看各包将包含的文件..."
+	@echo ""
+	@echo "1️⃣  mcp-common:"
+	cd mcp-common && cargo package --list
+	@echo ""
+	@echo "2️⃣  mcp-sse-proxy:"
+	cd mcp-sse-proxy && cargo package --list
+	@echo ""
+	@echo "3️⃣  mcp-streamable-proxy:"
+	cd mcp-streamable-proxy && cargo package --list
+	@echo ""
+	@echo "4️⃣  mcp-stdio-proxy:"
+	cd mcp-proxy && cargo package --list
+
+# 清理构建文件
+.PHONY: clean
+clean:
+	@echo "🧹 清理构建文件..."
+	rm -rf $(OUTPUT_DIR)
+	@echo "✅ 清理完成"
+
+
+
+# 清理 Docker 镜像
+.PHONY: clean-images
+clean-images:
+	@echo "🧹 清理 Docker 镜像..."
+	docker rmi $(IMAGE_NAME):latest 2>/dev/null || true
+	docker builder prune -f
+	@echo "✅ Docker 镜像清理完成"
+
+# 显示帮助信息
+.PHONY: help
+help:
+	@echo "📖 可用的 Make 命令:"
+	@echo ""
+	@echo "  📄 Document Parser 构建:"
+	@echo "    make build-document-parser-x86_64   - 构建 document-parser Linux x86_64 版本（默认）"
+	@echo "    make build-document-parser-arm64    - 构建 document-parser Linux ARM64 版本"
+	@echo "    make build-document-parser-multi    - 构建 document-parser 多平台版本"
+	@echo ""
+	@echo "  🎤 Voice CLI 构建:"
+	@echo "    make build-voice-cli-x86_64         - 构建 voice-cli Linux x86_64 版本"
+	@echo "    make build-voice-cli-arm64          - 构建 voice-cli Linux ARM64 版本"
+	@echo "    make build-voice-cli-multi          - 构建 voice-cli 多平台版本"
+	@echo ""
+	@echo "  🔌 MCP Proxy 构建:"
+	@echo "    make build-mcp-proxy                - 构建 mcp-proxy（当前系统架构）"
+	@echo ""
+	@echo "  🔧 所有组件构建:"
+	@echo "    make build-all                      - 构建所有组件（当前系统架构）"
+	@echo ""
+	@echo "  🐳 Docker 镜像:"
+	@echo "    make build-image                    - 构建 mcp-proxy Docker 运行镜像"
+	@echo "    make build-image-document-parser    - 构建 document-parser Docker 运行镜像"
+	@echo ""
+	@echo "  🚀 运行命令:"
+	@echo "    make run                            - 构建 + 后台启动 mcp-proxy（docker-compose -d）"
+	@echo "    make run-fg                         - 构建 + 前台启动 mcp-proxy（docker-compose）"
+	@echo "    make run-document-parser            - 运行 document-parser Docker 镜像"
+	@echo ""
+	@echo "  🛠️ 工具命令:"
+	@echo "    make check-buildx                   - 检查 Docker buildx 状态"
+	@echo "    make setup-buildx                   - 设置 Docker buildx builder"
+	@echo ""
+	@echo "  📦 MCP 发布命令:"
+	@echo "    make mcp-version-show               - 显示当前所有 MCP 包的版本号"
+	@echo "    make mcp-version-update             - 自动更新版本号（小版本号加一）"
+	@echo "    make mcp-publish                    - 发布所有 MCP 包到 crates.io（按依赖顺序）"
+	@echo "    make mcp-publish-dry-run            - 预览将要发布的内容（不实际发布）"
+	@echo "    make mcp-package-list               - 查看各包将包含的文件列表"
+	@echo ""
+	@echo "  🧹 清理命令:"
+	@echo "    make clean                          - 清理所有构建文件"
+	@echo "    make clean-images                   - 清理 Docker 镜像"
+	@echo ""
+	@echo "  ❓ 其他:"
+	@echo "    make help                           - 显示此帮助信息"
+	@echo ""
+	@echo "📝 示例用法:"
+	@echo "    make                                # 构建 document-parser Linux x86_64 版本"
+	@echo "    make build-mcp-proxy                # 构建 mcp-proxy（当前架构）"
+	@echo "    make build-all                      # 构建所有组件（当前架构）"
+	@echo "    make build-image                    # 构建 mcp-proxy Docker 镜像"
+	@echo "    make run                            # 构建 + 后台启动 mcp-proxy 服务"
+	@echo "    make run-fg                         # 构建 + 前台启动 mcp-proxy 服务"
+	@echo "    make mcp-version-show               # 查看当前版本号"
+	@echo "    make mcp-publish-dry-run            # 预览 MCP 发布（建议先运行此命令）"
+	@echo ""
+	@echo "📊 输出目录: ./dist/"
+	@echo "    mcp-proxy/                          # MCP Proxy 二进制文件（当前架构）"
+	@echo "    document-parser-x86_64/             # Document Parser x86_64 二进制文件"
+	@echo "    document-parser-arm64/              # Document Parser ARM64 二进制文件"
+	@echo "    voice-cli-x86_64/                   # Voice CLI x86_64 二进制文件"
+	@echo "    voice-cli-arm64/                    # Voice CLI ARM64 二进制文件"
+	@echo ""
+	@echo "📁 Docker 目录: ./docker/"
+	@echo "    Dockerfile.mcp-proxy                # mcp-proxy Docker 构建文件"
+	@echo "    Dockerfile.document-parser          # document-parser/voice-cli Docker 构建文件"
+	@echo "    config.yml                          # mcp-proxy 默认配置文件"
+	@echo "    docker-compose.yml                  # Docker Compose 配置文件"