MCP Neurolora

一个智能的MCP服务器，提供使用OpenAI API进行代码分析、代码收集和文档生成的工具。

🚀 安装指南

如果你还没有安装任何东西，请放心！只需按照以下步骤操作或请求助手帮助你完成安装。

第一步：安装Node.js

macOS

1. 如果未安装Homebrew，请先安装：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装Node.js 18：

   brew install node@18
   echo 'export PATH="/opt/homebrew/opt/node@18/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc
   

Windows

1. 从nodejs.org下载Node.js 18 LTS
2. 运行安装程序
3. 打开一个新的终端以应用更改

Linux (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

第二步：安装uv和uvx

所有操作系统

1. 安装uv：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 安装uvx：

   uv pip install uvx
   

第三步：验证安装

运行以下命令来验证是否已正确安装：

node --version  # 应显示v1.8.x.x
npm --version   # 应显示9.x.x或更高版本
uv --version    # 应显示已安装uv
uvx --version   # 应显示已安装uvx

第四步：配置MCP服务器

你的助手会帮助你：

1. 查找你的Cline设置文件：

   • VSCode: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows VSCode: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows Claude: %APPDATA%/Claude/claude_desktop_config.json

2. 添加以下配置：

   {
     "mcpServers": {
       "aindreyway-mcp-neurolora": {
         "command": "npx",
         "args": ["-y", "@aindreyway/mcp-neurolora@latest"],
         "env": {
           "NODE_OPTIONS": "--max-old-space-size=256",
           "OPENAI_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

第五步：安装基础服务器

只需请求助手：

"请为我的环境安装基础MCP服务器"

你的助手会：

1. 查找你的设置文件
2. 运行install_base_servers工具
3. 自动配置所有必要的服务器

安装完成后：

1. 完全关闭VSCode（macOS上使用Cmd+Q，Windows上使用Alt+F4）
2. 重新打开VSCode
3. 新的服务器将准备好使用

重要提示： 在安装基础服务器后，需要完全重启VSCode才能正确初始化它们。

注意： 此服务器使用npx直接执行npm包，这对于Node.js/TypeScript MCP服务器来说是最优选择，提供了与npm生态系统和TypeScript工具无缝集成的能力。

基础MCP服务器

以下基础服务器将被自动安装和配置：

• fetch: 访问网络资源的基本HTTP请求功能
• puppeteer: 浏览器自动化能力，用于网络交互和测试
• sequential-thinking: 高级问题解决工具，适用于复杂任务
• github: GitHub集成功能，用于仓库管理
• git: 版本控制支持的Git操作
• shell: 带有常见命令的基本shell命令执行：
  • ls: 列出目录内容
  • cat: 显示文件内容
  • pwd: 打印工作目录
  • grep: 搜索文本模式
  • wc: 统计单词、行数、字符数
  • touch: 创建空文件
  • find: 搜索文件

🎯 助手可以做什么

请求助手：

• "分析我的代码并提出改进建议"
• "为我的环境安装基础MCP服务器"
• "从我的项目目录收集代码"
• "为我的代码库创建文档"
• "生成包含我所有代码的markdown文件"

🛠 可用工具

analyze_code

使用OpenAI API分析代码，并生成详细的反馈和改进建议。

参数：

• codePath（必需）：要分析的代码文件或目录路径

示例用法：

{
  "codePath": "/path/to/your/code.ts"
}

该工具将：

1. 使用OpenAI API分析你的代码
2. 生成详细的反馈，包括：
   • 问题和建议
   • 最佳实践违规
   • 影响分析
   • 解决步骤
3. 在你的项目中创建两个输出文件：
   • LAST_RESPONSE_OPENAI.txt - 人类可读的分析
   • LAST_RESPONSE_OPENAI_GITHUB_FORMAT.json - 结构化数据，用于GitHub问题

注意：需要在环境配置中提供OpenAI API密钥

collect_code

从目录中收集所有代码到一个带有语法高亮和导航的单个markdown文件中。

参数：

• directory（必需）：要收集代码的目录路径
• outputPath（可选）：保存输出markdown文件的路径
• ignorePatterns（可选）：忽略的模式数组（类似于.gitignore）

示例用法：

{
  "directory": "/path/to/project/src",
  "outputPath": "/path/to/project/src/FULL_CODE_SRC_2024-12-20.md",
  "ignorePatterns": ["*.log", "temp/", "__pycache__", "*.pyc", ".git"]
}

install_base_servers

将基础MCP服务器安装到配置文件中。

参数：

• configPath（必需）：MCP设置配置文件的路径

示例用法：

{
  "configPath": "/path/to/cline_mcp_settings.json"
}

🔧 特性

该服务器提供：

• 代码分析：

  • OpenAI API集成
  • 结构化反馈
  • 最佳实践建议
  • GitHub问题生成

• 代码收集：

  • 目录遍历
  • 语法高亮
  • 导航生成
  • 基于模式的过滤

• 基础服务器管理：

  • 自动安装
  • 配置处理
  • 版本管理

📄 许可证

MIT许可证 - 随意在你的项目中使用！

👤 作者

Aindreyway

• GitHub: @aindreyway

⭐️ 支持

如果这个项目对你有帮助，请给⭐️点赞！