@iflow-mcp/apple-rag-mcp 4.6.2

package/.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 8
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Run semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: pnpm exec semantic-release
+
+      - name: Build project
+        run: pnpm run build
+
+      - name: Deploy to Development
+        if: success()
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+        run: |
+          pnpm install -g wrangler
+          pnpm run deploy:dev
+
+      - name: Deploy to Production
+        if: success()
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+        run: pnpm run deploy:prod
+
+

package/.releaserc.json

@@ -0,0 +1,38 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "releaseRules": [
+          { "type": "docs", "release": "patch" },
+          { "type": "style", "release": "patch" },
+          { "type": "refactor", "release": "patch" },
+          { "type": "perf", "release": "patch" }
+        ]
+      }
+    ],
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    [
+      "@semantic-release/npm",
+      {
+        "npmPublish": false
+      }
+    ],
+    "./scripts/semantic-release-server-json.js",
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["package.json", "server.json", "CHANGELOG.md"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    [
+      "@semantic-release/github",
+      {
+        "assets": []
+      }
+    ]
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,161 @@
+## [4.6.2](https://github.com/BingoWon/apple-rag-mcp/compare/v4.6.1...v4.6.2) (2025-12-08)
+
+
+### Bug Fixes
+
+* preserve capitalized meta-descriptive words in query cleaner ([e378a89](https://github.com/BingoWon/apple-rag-mcp/commit/e378a89affaa9aab626b7498919ccf19750b2d1c))
+
+## [4.6.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.6.0...v4.6.1) (2025-12-03)
+
+# [4.6.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.5.1...v4.6.0) (2025-12-01)
+
+
+### Features
+
+* more generous rate limits and clearer usage guidance ([7daf6bc](https://github.com/BingoWon/apple-rag-mcp/commit/7daf6bc79a564d88d246e0cfbabfe48efd533abe))
+
+# [4.6.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.5.1...v4.6.0) (2025-12-01)
+
+
+### Features
+
+* more generous rate limits and clearer usage guidance ([7daf6bc](https://github.com/BingoWon/apple-rag-mcp/commit/7daf6bc79a564d88d246e0cfbabfe48efd533abe))
+
+## [4.5.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.5.0...v4.5.1) (2025-11-30)
+
+# [4.5.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.4.2...v4.5.0) (2025-11-27)
+
+
+### Features
+
+* **d1:** add timeout protection and background writes for D1 operations ([3b87b63](https://github.com/BingoWon/apple-rag-mcp/commit/3b87b6355b14ad6a459516bd7ce73b27e7a41ca6))
+
+## [4.4.2](https://github.com/BingoWon/apple-rag-mcp/compare/v4.4.1...v4.4.2) (2025-11-27)
+
+## [4.4.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.4.0...v4.4.1) (2025-11-27)
+
+# [4.4.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.3.3...v4.4.0) (2025-11-27)
+
+
+### Features
+
+* **reranker:** implement dual-model fallback with 8B→4B degradation ([3daf9cf](https://github.com/BingoWon/apple-rag-mcp/commit/3daf9cfea01656c8034bad7940aeb0ba282b664c))
+
+## [4.3.3](https://github.com/BingoWon/apple-rag-mcp/compare/v4.3.2...v4.3.3) (2025-11-27)
+
+
+### Bug Fixes
+
+* use ctx.waitUntil() for Telegram notifications ([c53bc8f](https://github.com/BingoWon/apple-rag-mcp/commit/c53bc8f06177c3d76be7e43b6d18fac5bdfe0ba3))
+
+## [4.3.2](https://github.com/BingoWon/apple-rag-mcp/compare/v4.3.1...v4.3.2) (2025-11-27)
+
+## [4.3.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.3.0...v4.3.1) (2025-11-26)
+
+# [4.3.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.2.1...v4.3.0) (2025-11-26)
+
+
+### Features
+
+* add requested_query and actual_query fields for search logs ([470bae8](https://github.com/BingoWon/apple-rag-mcp/commit/470bae81f3d082b3dfa0272fea5141da564b0c41))
+
+## [4.2.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.2.0...v4.2.1) (2025-11-26)
+
+# [4.2.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.7...v4.2.0) (2025-11-26)
+
+
+### Features
+
+* add country_code tracking from Cloudflare ([d1777bb](https://github.com/BingoWon/apple-rag-mcp/commit/d1777bba8c93553878d32b79c067cf46d952de1f))
+
+## [4.1.7](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.6...v4.1.7) (2025-11-26)
+
+## [4.1.6](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.5...v4.1.6) (2025-11-23)
+
+## [4.1.5](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.4...v4.1.5) (2025-11-06)
+
+## [4.1.4](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.3...v4.1.4) (2025-11-06)
+
+
+### Bug Fixes
+
+* remove legacy SSE support ([82224c0](https://github.com/BingoWon/apple-rag-mcp/commit/82224c06beefb200171bb9efa411987fcc0723e8))
+
+## [4.1.3](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.2...v4.1.3) (2025-10-08)
+
+
+### Bug Fixes
+
+* enhance token extraction to handle multiple Bearer prefixes and improve error logging ([c8f0c73](https://github.com/BingoWon/apple-rag-mcp/commit/c8f0c735c7f5319b9bb7f9f99b2ca188c2657864))
+
+## [4.1.2](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.1...v4.1.2) (2025-10-07)
+
+## [4.1.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.1.0...v4.1.1) (2025-10-04)
+
+
+### Bug Fixes
+
+* add keep_vars to preserve Cloudflare Secrets on deploy ([d840d06](https://github.com/BingoWon/apple-rag-mcp/commit/d840d06108118ca881252a80fb2000f6a71e1f94))
+
+# [4.1.0](https://github.com/BingoWon/apple-rag-mcp/compare/v4.0.2...v4.1.0) (2025-10-04)
+
+
+### Features
+
+* configure semantic-release to trigger patch releases for docs and style commits ([0f1c4ae](https://github.com/BingoWon/apple-rag-mcp/commit/0f1c4ae9bcd15651d89ac86e1ce67ca3c107de30))
+
+## [4.0.2](https://github.com/BingoWon/apple-rag-mcp/compare/v4.0.1...v4.0.2) (2025-09-30)
+
+
+### Bug Fixes
+
+* remove duplicate v4.0.1 entry in CHANGELOG.md ([45a7748](https://github.com/BingoWon/apple-rag-mcp/commit/45a7748716b6e7e07436056bd035b258226553da))
+
+## [4.0.1](https://github.com/BingoWon/apple-rag-mcp/compare/v4.0.0...v4.0.1) (2025-09-30)
+
+
+### Bug Fixes
+
+* simplify deployment workflow ([1ebb758](https://github.com/BingoWon/apple-rag-mcp/commit/1ebb75821b1116cb8ca1ca0725978d1434403039))
+* test patch release workflow ([15d1126](https://github.com/BingoWon/apple-rag-mcp/commit/15d1126b92fba30c72fd67aa9613848f42540610))
+
+# [4.0.0](https://github.com/BingoWon/apple-rag-mcp/compare/v3.0.1...v4.0.0) (2025-09-30)
+
+
+### Features
+
+* migrate to Cloudflare Workers Secrets for secure configuration ([98b8bba](https://github.com/BingoWon/apple-rag-mcp/commit/98b8bbac930bcbfb0efe40e5adb4da854ccb6c0b))
+
+
+### BREAKING CHANGES
+
+* Environment variables moved from wrangler.toml to Cloudflare Secrets
+
+## [3.0.1](https://github.com/BingoWon/apple-rag-mcp/compare/v3.0.0...v3.0.1) (2025-09-26)
+
+
+### Bug Fixes
+
+* add build step before deployment in CI workflow ([e474a22](https://github.com/BingoWon/apple-rag-mcp/commit/e474a227ced60839f2cf0a84eccc681bac5982b4))
+
+# [3.0.0](https://github.com/BingoWon/apple-rag-mcp/compare/v2.9.1...v3.0.0) (2025-09-25)
+
+
+### Bug Fixes
+
+* add workflow_dispatch trigger for manual release testing ([610e345](https://github.com/BingoWon/apple-rag-mcp/commit/610e34585d6afa14c1288fcbe76c187c9aefdc01))
+* convert semantic-release plugin to ES modules ([c96767a](https://github.com/BingoWon/apple-rag-mcp/commit/c96767a884f09de93670b6c577dce7287857e91f))
+* correct GitHub Actions workflow configuration ([bcb06d0](https://github.com/BingoWon/apple-rag-mcp/commit/bcb06d0dc07790774579fca171f34c4fc6a6f209))
+* resolve pnpm lockfile compatibility issue in CI ([e5012be](https://github.com/BingoWon/apple-rag-mcp/commit/e5012be43766609ffb4328dc5bf7b9db48e8a9a4))
+* restore complete pnpm-only workflow with proper action setup ([d1f27bf](https://github.com/BingoWon/apple-rag-mcp/commit/d1f27bf8c0479f1c7146100e68d6b8aa668ec74c))
+* simplify GitHub Actions workflow for semantic-release testing ([0857757](https://github.com/BingoWon/apple-rag-mcp/commit/08577575cca72db89421375f046d1fa3ea7ae265))
+
+
+### Features
+
+* migrate to semantic-release for modern automated releases ([9f90ed7](https://github.com/BingoWon/apple-rag-mcp/commit/9f90ed772aefcf7dc59b6fa3cf78a04373785345))
+
+
+### BREAKING CHANGES
+
+* Release process now fully automated via GitHub Actions

package/README.md

@@ -0,0 +1,114 @@
+<div align="center">
+
+<img src="https://apple-rag.com/logo-with-text.svg" alt="Apple RAG MCP" width="400">
+
+### The Apple docs MCP your AI actually deserves.
+
+*370,000+ docs. 1,300+ WWDC transcripts. Semantic + keyword + hybrid search. One clean tool.*
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en/install-mcp?name=apple-rag-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5hcHBsZS1yYWcuY29tIn0%3D)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Apple_RAG_MCP-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Apple_RAG_MCP-24bfa5?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode-insiders:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D)
+
+[🌐 Website](https://apple-rag.com) • [📊 Dashboard](https://apple-rag.com/overview)
+
+**English** | [中文](./README.zh-CN.md)
+
+</div>
+
+---
+
+## Not Just Another Docs Tool
+
+Others give you keyword search. We give you that, plus semantic understanding, plus AI-powered hybrid search that combines both intelligently. Every search mode you need, working together.
+
+**Minimal footprint. Maximum signal.** Our MCP tools are designed to be lean—no bloated responses, no wasted tokens, no noise cluttering your agent's context. Just the information that matters.
+
+---
+
+## Start in Seconds
+
+**One click:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en/install-mcp?name=apple-rag-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5hcHBsZS1yYWcuY29tIn0%3D)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Apple_RAG_MCP-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Apple_RAG_MCP-24bfa5?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode-insiders:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D)
+
+Click the button above and your editor will automatically configure everything for you in seconds.
+
+### Option 2: Manual Setup for Other MCP Clients
+
+**JSON Configuration (Copy & Paste):**
+```json
+{
+  "mcpServers": {
+    "apple-rag-mcp": {
+      "url": "https://mcp.apple-rag.com"
+    }
+  }
+}
+```
+
+**Manual Configuration Parameters:**
+- **MCP Type:** `Streamable HTTP`
+- **URL:** `https://mcp.apple-rag.com`
+- **Authentication:** `Optional` (MCP Token for higher limits)
+- **MCP Token:** Get yours at [apple-rag.com](https://apple-rag.com) for increased quota
+
+**Supported Clients:** Cursor, Claude Desktop, Cline, and all MCP-compatible tools.
+
+> **Note:** No MCP Token required to start! You get free queries without any authentication. Add an MCP Token later for higher usage limits.
+
+## 🌟 Why Developers Love Apple RAG MCP
+
+<table>
+<tr>
+<td width="50%">
+
+### ⚡ **Fast & Reliable**
+Get quick responses with our optimized search infrastructure. No more hunting through docs.
+
+### 🎯 **AI-Powered Hybrid Search**
+Advanced search technology combining Semantic Search for RAG, Keyword Search, and Hybrid Search with vector similarity and technical term matching provides accurate, contextual answers from Apple's documentation.
+
+### 🔒 **Always Secure**
+MCP authentication ensures trusted access for your AI agents with enterprise-grade security.
+
+</td>
+<td width="50%">
+
+### 📝 **Code Examples**
+Get practical code examples in Swift, Objective-C, and SwiftUI alongside documentation references.
+
+### 🔄 **Real-time Updates**
+Our documentation index is continuously updated to reflect the latest Apple developer resources.
+
+### 🆓 **Completely Free**
+Start immediately with no MCP Token required. Get an MCP Token for higher usage limits - all managed at [apple-rag.com](https://apple-rag.com).
+
+</td>
+</tr>
+</table>
+
+## 🎯 Features
+
+- **🔍 Semantic Search for RAG** - Vector similarity with semantic understanding for intelligent retrieval
+- **🔎 Keyword Search** - Precise technical term matching for API names and specific terminology
+- **🎯 Hybrid Search** - Combined semantic and keyword search with AI reranking for optimal results
+- **📚 Complete Coverage** - iOS, macOS, watchOS, tvOS, visionOS documentation
+- **🎬 WWDC Videos** - Full transcripts from Apple Developer videos and WWDC sessions
+- **⚡ Fast Response** - Optimized for speed across all content types
+- **🚀 High Performance** - Multi-instance cluster deployment for maximum throughput
+- **🔄 Always Current** - Synced with Apple's latest docs and video content
+- **🛡️ Secure & Private** - Your queries stay private
+- **🌐 Universal MCP** - Works with any MCP-compatible client
+
+<div align="center">
+
+---
+
+**Better docs. Better context. Better code.**
+
+[Get Started →](https://apple-rag.com)
+
+</div>

package/README.zh-CN.md

@@ -0,0 +1,119 @@
+<div align="center">
+
+<img src="https://apple-rag.com/logo-with-text.svg" alt="Apple RAG MCP" width="400">
+
+### 为 AI 智能体打造的 Apple 文档 MCP
+
+*覆盖 37 万+ 文档、1,300+ 条 WWDC 视频字幕。支持语义 / 关键词 / 混合搜索，一站式把答案递到你的智能体手中。*
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en/install-mcp?name=apple-rag-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5hcHBsZS1yYWcuY29tIn0%3D)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Apple_RAG_MCP-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Apple_RAG_MCP-24bfa5?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode-insiders:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D)
+
+[🌐 官网](https://apple-rag.com) • [📊 控制台](https://apple-rag.com/overview)
+
+[English](./README.md) | **中文**
+
+</div>
+
+---
+
+## 不只是查文档
+
+多数工具只能做关键词匹配。Apple RAG MCP 在关键词搜索之外加入语义理解，并用 AI 混合搜索把两者结合，把真正有用的上下文精准送到你的智能体。
+
+**精简高效。** 响应克制、不啰嗦，尽量少占用 token，不打乱智能体的上下文，只保留最有价值的信号。
+
+---
+
+## 方式一：秒速开始
+
+**免费对话体验：**
+- [阿里云百宝箱网页应用 - 苹果应用开发专家](https://tbox.alipay.com/inc/share/202511APsocn07628729?platform=WebService)
+- [阿里云百宝箱 MCP 插件（需先登录） - 苹果开发文档检索 / Apple RAG MCP](https://tbox.alipay.com/inc/plugin-market/plugin-detail/20251130R4pz05084592)
+
+**一键安装：**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en/install-mcp?name=apple-rag-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5hcHBsZS1yYWcuY29tIn0%3D)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Apple_RAG_MCP-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Apple_RAG_MCP-24bfa5?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode-insiders:mcp/install?%7B%22name%22%3A%22apple-rag-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.apple-rag.com%22%7D)
+
+点击上面的按钮，在 IDE 中自动填充 MCP 配置，几秒钟即可使用。
+
+### 方式二：为其他 MCP 客户端手动配置
+
+**JSON 配置（直接粘贴）：**
+```json
+{
+  "mcpServers": {
+    "apple-rag-mcp": {
+      "url": "https://mcp.apple-rag.com"
+    }
+  }
+}
+```
+
+**手动配置参数：**
+- **MCP 类型：** `Streamable HTTP`
+- **URL：** `https://mcp.apple-rag.com`
+- **认证：** `可选`（添加 MCP Token 可提升配额）
+- **MCP Token：** 在 [apple-rag.com](https://apple-rag.com) 获取
+
+**支持的客户端：** 通义灵码、Cursor、Claude Desktop、Cline，以及任何兼容 MCP 的工具。
+
+> **提示：** 开箱即可免费使用，无需 Token。需要更高额度时，再添加 MCP Token。
+
+## 🌟 开发者为什么选 Apple RAG MCP
+
+<table>
+<tr>
+<td width="50%">
+
+### ⚡ **响应迅捷**
+优化的搜索基础设施，结果反馈更快，省去翻找文档的时间。
+
+### 🎯 **AI 混合搜索**
+语义 + 关键词 + 向量重排序，精准锁定 Apple 文档里的上下文答案。
+
+### 🔒 **安全可信**
+MCP 认证链路，确保你的智能体获得安全、可控的访问。
+
+</td>
+<td width="50%">
+
+### 📝 **示例随取随用**
+提供 Swift、Objective-C、SwiftUI 的实用代码示例和文档。
+
+### 🔄 **持续更新**
+文档索引与 Apple 开发者资源持续同步，保持最新。
+
+### 🆓 **免费上手**
+无需 Token 即可使用；可在 [apple-rag.com](https://apple-rag.com) 获取更多配额。
+
+</td>
+</tr>
+</table>
+
+## 🎯 核心能力
+
+- **🔍 RAG 语义搜索** - 基于语义理解的向量相似度检索
+- **🔎 关键词搜索** - 精准匹配 API 名称和技术术语
+- **🎯 混合搜索** - 语义 + 关键词 + AI 重排序，挑出最佳结果
+- **📚 全面覆盖** - 覆盖 iOS、macOS、watchOS、tvOS、visionOS 文档
+- **🎬 WWDC 视频** - 收录 Apple 开发者视频与 WWDC session 字幕
+- **⚡ 快速响应** - 针对所有内容类型优化查询速度
+- **🚀 高性能** - 多实例集群带来高吞吐
+- **🔄 始终最新** - 持续同步最新文档与视频
+- **🛡️ 安全私密** - 查询保持私密与安全
+- **🌐 通用 MCP** - 兼容所有支持 MCP 的客户端
+
+<div align="center">
+
+---
+
+**更优质的文档，更清晰的上下文，更踏实的代码。**
+
+[立即开始 →](https://apple-rag.com)
+
+</div>
+

package/apple-rag-mcp_process.log

@@ -0,0 +1,8 @@
+[2025-12-29] [✅] 获取项目信息: https://github.com/BingoWon/apple-rag-mcp
+[2025-12-29] [✅] Fork和克隆: 成功克隆到 /Users/jiashuowang/MCPs/提示词项目/iflow_auto_import/data/apple-rag-mcp
+[2025-12-29] [✅] 阅读代码: Node.js/TypeScript项目，使用Cloudflare Workers，streamable-http协议
+[2025-12-29] [✅] 修改配置文件: package.json已修改，name改为@iflow-mcp/BingoWon_apple-rag-mcp
+[2025-12-29] [✅] 修复代码问题: 无需修复，Cloudflare Workers项目
+[2025-12-29] [✅] 构建项目: TypeScript构建成功
+[2025-12-29] [⚠️] 本地测试: 项目使用streamable-http协议，需要Cloudflare Workers和D1数据库环境，无法进行stdio本地测试。项目已部署在https://mcp.apple-rag.com
+[2025-12-29] [✅] 创建并推送iflow分支: 已成功创建并推送到远程

package/biome.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.2/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 80
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "warn",
+        "noArrayIndexKey": "off"
+      },
+      "style": {
+        "noNonNullAssertion": "off"
+      },
+      "complexity": {
+        "noForEach": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "jsxQuoteStyle": "double",
+      "trailingCommas": "es5",
+      "semicolons": "always",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "json": {
+    "formatter": {
+      "enabled": true,
+      "indentStyle": "space",
+      "indentWidth": 2
+    }
+  }
+}

package/dist/src/auth/auth-middleware.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Simple MCP Authentication Middleware
+ */
+import type { AuthContext } from "../types/index.js";
+import { type UserTokenData } from "./token-validator.js";
+export declare class AuthMiddleware {
+    private readonly tokenValidator;
+    private readonly ipAuthService;
+    constructor(d1: D1Database);
+    /**
+     * Extract Bearer token from Authorization header
+     * Handles multiple "Bearer" prefixes and validates token format
+     */
+    private extractBearerToken;
+    /**
+     * Optional authentication middleware
+     * Validates token if present, or checks IP-based authentication, allows access without either
+     */
+    optionalAuth(request: Request): Promise<AuthContext>;
+    getUserData(userId: string): Promise<UserTokenData>;
+    /**
+     * Get client IP address from request (Worker optimized)
+     */
+    private getClientIP;
+}
+//# sourceMappingURL=auth-middleware.d.ts.map

package/dist/src/auth/auth-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../../../src/auth/auth-middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;gBAE5C,EAAE,EAAE,UAAU;IAK1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAmDpD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzD;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB"}

package/dist/src/auth/auth-middleware.js

@@ -0,0 +1,77 @@
+/**
+ * Simple MCP Authentication Middleware
+ */
+import { IPAuthenticationService } from "../services/ip-authentication.js";
+import { logger } from "../utils/logger.js";
+import { TokenValidator } from "./token-validator.js";
+export class AuthMiddleware {
+    tokenValidator;
+    ipAuthService;
+    constructor(d1) {
+        this.tokenValidator = new TokenValidator(d1);
+        this.ipAuthService = new IPAuthenticationService(d1);
+    }
+    /**
+     * Extract Bearer token from Authorization header
+     * Handles multiple "Bearer" prefixes and validates token format
+     */
+    extractBearerToken(authHeader) {
+        if (!authHeader)
+            return null;
+        // Remove all "Bearer " prefixes (case-insensitive, supports multiple)
+        const token = authHeader.replace(/^(Bearer\s+)+/gi, "").trim();
+        // Only return if it matches valid token format
+        return /^at_[a-f0-9]{32}$/.test(token) ? token : null;
+    }
+    /**
+     * Optional authentication middleware
+     * Validates token if present, or checks IP-based authentication, allows access without either
+     */
+    async optionalAuth(request) {
+        const authHeader = request.headers.get("authorization");
+        const token = this.extractBearerToken(authHeader || undefined);
+        const clientIP = this.getClientIP(request);
+        // Try token authentication first
+        if (token) {
+            const validation = await this.tokenValidator.validateToken(token);
+            if (validation.valid) {
+                logger.info(`Token authentication successful for userId: ${validation.userData?.userId}`);
+                return {
+                    isAuthenticated: true,
+                    userId: validation.userData?.userId,
+                    email: validation.userData?.email,
+                    token: token,
+                };
+            }
+            logger.error(`Token validation failed. Raw header: "${authHeader}", Extracted token: "${token}", IP: ${clientIP}, Error: ${validation.error}`);
+        }
+        // Try IP-based authentication
+        const ipAuthResult = await this.ipAuthService.checkIPAuthentication(clientIP);
+        if (ipAuthResult) {
+            logger.info(`IP-based authentication successful for userId: ${ipAuthResult.userId} from IP: ${clientIP}`);
+            return {
+                isAuthenticated: true,
+                userId: ipAuthResult.userId,
+                email: ipAuthResult.email,
+                token: "ip-based",
+            };
+        }
+        // No authentication method succeeded
+        logger.info(`No authentication provided - allowing unauthenticated access from IP: ${clientIP} (hasToken: ${!!token})`);
+        return { isAuthenticated: false };
+    }
+    async getUserData(userId) {
+        return this.tokenValidator.getUserDataById(userId);
+    }
+    /**
+     * Get client IP address from request (Worker optimized)
+     */
+    getClientIP(request) {
+        // Cloudflare provides client IP in CF-Connecting-IP header
+        return (request.headers.get("CF-Connecting-IP") ||
+            request.headers.get("X-Forwarded-For") ||
+            request.headers.get("X-Real-IP") ||
+            "unknown");
+    }
+}
+//# sourceMappingURL=auth-middleware.js.map