Cosa Sai

🚀 MCP服務器項目

本項目實現了一個MCP服務器，該服務器藉助Gemini API，為用戶提供各種技術文檔的訪問服務，尤其適用於Roo/Cline環境。通過利用Gemini的大上下文窗口特性，用戶能夠更高效地探索和理解不同的技術內容。

🚀 快速開始

本MCP服務器利用Gemini API的強大能力，為用戶提供了便捷的技術文檔訪問途徑。藉助大上下文窗口，用戶可以更高效地探索和理解不同技術。

✨ 主要特性

1. 訪問精選知識庫：用戶可直接獲取經過整理的技術文檔，無需自行收集信息。
2. 克服上下文窗口限制：Gemini API強大的功能讓我們能夠處理更大的文檔內容，提升查詢效率。
3. 支持多種技術：服務器可擴展以支持更多不同的技術領域。
4. 支持多種查詢工具：
   • can_x_be_done：檢查特定任務是否可以在指定技術中實現。
   • hints_for_problem：獲取解決問題的提示和建議。
   • is_this_good_practice：評估代碼片段是否遵循良好的編程實踐。
   • how_to_do_x：提供完成特定任務的方法和替代方案。

📦 安裝指南

通過Smithery安裝

gem install gemini-docs-mcp-server

配置示例

{
  "server": {
    "host": "localhost",
    "port": 3000,
    "apiKey": "your_api_key_here"
  },
  "tools": [
    {
      "name": "can_x_be_done",
      "enabled": true
    }
  ]
}

💻 使用示例

基礎用法

知識庫獲取與淨化

網頁抓取腳本

wget --mirror --convert-links --adjust-extension --page-requisites --no-parent --directory-prefix=./local_copy --no-verbose --show-progress $1

文檔轉換工具

#!/bin/bash

目錄="${1:-.}"  # 默認當前目錄如果沒有提供參數
輸出文件="${2:-concatenated.md}"  # 默認輸出文件名

echo "正在將'$目錄'中的文件合併到'$輸出文件'..."
# 清空輸出文件如果存在
truncate -s 0 "$輸出文件"

# 查找所有文件（不包括目錄）並處理它們
find "$目錄" -type f -name '*.html' | while IFS= read -r file; do
    echo "=== ${file#./} ===" >> "$輸出文件"
    cat "$file" \
    | grep -v 'base64' \
    | html2markdown >> "$輸出文件"
    echo -e "\n" >> "$輸出文件"
done

echo "完成！輸出保存到'$輸出文件'"

高級用法

工具使用說明

• can_x_be_done：檢查特定任務是否可以在指定技術中實現。
  • 輸入：docs, prompt, x, technology
  • 輸出：success, data
• hints_for_problem：獲取解決問題的提示。
  • 輸入：docs, prompt, problem, context, environment
  • 輸出：success, data
• is_this_good_practice：評估代碼片段是否遵循良好的編程實踐。
  • 輸入：docs, prompt, snippet, context
  • 輸出：success, data
• how_to_do_x：提供完成特定任務的方法和替代方案。
  • 輸入：docs, prompt, x, technology
  • 輸出：success, data

📚 詳細文檔

貢獻指南

1. 創建功能分支：為新功能或修復問題創建新的分支。
2. 提交代碼：確保提交信息描述清晰，便於追蹤變更。
3. 提出拉取請求：將您的更改合併到主分支。

📄 許可證

本項目採用MIT許可證。

⚠️ 重要提示

此版本仍處於早期階段，可能存在錯誤和限制。如遇問題，請隨時報告並歡迎提出改進建議。