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许可证。

⚠️ 重要提示

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