项目描述

此项目实现了一个MCP服务器，该服务器使用Gemini API提供各种技术文档的访问，特别针对Roo/Cline环境。通过利用Gemini的大上下文窗口，用户可以更高效地探索和理解不同技术。

优势

1. 访问 curated knowledge base：用户可以直接获取经过整理的技术文档，无需自行收集信息。
2. 克服 context window 限制：Gemini API的强大功能使我们能够处理更大的文档内容，提升查询效率。
3. 支持多种技术：服务器可以扩展以支持更多不同的技术领域。

功能特点

• 支持多种查询工具：
  • 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许可证。

免责声明

此版本仍处于早期阶段，可能存在错误和限制。如遇问题，请随时报告并欢迎提出改进建议。