Expo Gemini MCP Server

🚀 一个用于Expo文档的模型上下文协议（MCP）服务器，集成Gemini AI

该服务器通过Gemini AI的支持，使AI助手能够访问最新的Expo文档，以增强搜索结果并生成高质量的代码示例。

✨ 特性

• 🔍 语义搜索 使用Gemini嵌入在Expo文档中进行智能搜索
• 🤖 完全使用Gemini AI 使用Gemini进行嵌入和文本生成
• 📚 完整的文档 包括API参考、指南和教程
• 🎯 MCP协议 遵循模型上下文协议
• ⚡ 混合搜索 结合语义和关键词搜索
• 🔧 概念解释 对Expo概念进行详细解释

🛠 安装

系统要求

• Node.js (v16或更高版本)
• NPM 或 Yarn
• Gemini API密钥（必需）

第一步：克隆并安装

git clone <repository-url>
cd expo-gemini-mcp-server
npm install

第二步：配置环境

cp .env.example .env

编辑.env文件并添加Gemini API密钥：

GEMINI_API_KEY=your_gemini_api_key_here
PORT=3000
NODE_ENV=development

第三步：构建文档索引

npm run build-index

此命令将：

• 从GitHub克隆Expo文档
• 处理markdown文件
• 使用OpenAI创建嵌入
• 保存到向量存储

第四步：构建并启动服务器

npm run build
npm start

或者在开发模式下运行：

npm run dev

第五步：测试服务器

npm test

🎯 使用

可用的MCP工具

一 search_expo_docs

在Expo文档中进行AI增强的搜索

{
  "query": "如何在Expo中使用Image组件？",
  "maxResults": 5,
  "useGemini": true
}

二 get_expo_examples

获取特定组件/API的代码示例

{
  "component": "Camera",
  "complexity": "中级"
}

三 explain_expo_concept

对Expo概念进行详细解释

{
  "concept": "Expo Router",
  "audience": "初学者"
}

连接AI助手

Claude Desktop

添加到claude_desktop_config.json：

{
  "mcpServers": {
    "expo-gemini-docs": {
      "command": "node",
      "args": ["/path/to/expo-gemini-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_key",
        "GEMINI_API_KEY": "your_key"
      }
    }
  }
}

Cursor/VS Code

使用MCP扩展并配置服务器端点。

🧠 Gemini AI集成

增强搜索结果

Gemini AI将：

• 评估结果的相关性
• 为每个结果添加摘要
• 建议相关主题
• 强调重要信息

创建代码示例

Gemini可以创建：

• 完整且可执行的示例
• 常见用例
• 最佳实践
• 警告常见陷阱

解释概念

Gemini根据以下情况调整解释：

• 初学者 使用简单语言，包括设置步骤
• 中级 关注实际应用
• 专家 高级细节，性能考虑

📁 项目结构

expo-gemini-mcp-server/
├── src/
│   ├── index.ts              # 入口点
│   ├── services/
│   │   ├── GeminiService.ts  # 集成Gemini AI
│   │   ├── VectorStoreService.ts # 向量数据库
│   │   └── ExpoDocsService.ts    # 文档处理逻辑
│   └── utils/
│       └── logger.ts         # 日志工具
├── scripts/
│   └── build-index.js        # 构建文档索引脚本
├── data/                     # 向量存储和搜索索引
├── logs/                     # 日志文件
├── docs-source/              # Expo文档（克隆）
├── package.json
├── tsconfig.json
├── mcp-config.json          # MCP配置
└── README.md

🔧 可用脚本

• npm run build: 编译TypeScript为JavaScript
• npm start: 启动服务器（生产模式）
• npm run dev: 启动监视模式（开发模式）
• npm run build-index: 构建文档索引
• npm run update-docs: 更新文档并重建索引
• npm test: 测试服务器功能

🔍 故障排除

空向量存储

# 重新构建索引
npm run build-index

Gemini API错误

• 检查.env中的API密钥
• 核实配额和账单
• 检查网络连接

OpenAI嵌入错误

• 检查API密钥和信用额度
• 速率限制 - 自动暂停脚本
• 如需减少批处理大小

内存问题

• 提高Node.js内存限制：

node --max-old-space-size=4096 scripts/build-index.js

🤝 贡献

1. 分叉仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加了惊人的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建Pull Request

📄 许可证

根据MIT许可证分发。 详情请参阅LICENSE。

🙏 致谢

• Expo团队 制作出色的文档。
• Google AI - 提供Gemini API
• OpenAI - 提供嵌入模型
• 模型上下文协议 - 提供MCP标准

📞 支持

遇到问题？ 创建问题或通过email联系我们。

---

愉快地使用Expo和AI编程！ 🚀🤖