AI导哈

本地AI开发环境服务器

一个最小化的本地模型上下文协议（MCP）服务器，用于AI辅助开发环境，允许将本地代码库、配置文件和参考文档作为结构化资源暴露给Cursor或VS Code AI等工具。

  • by ilkergonenc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ilkergonenc/mcp-local-dev

使用说明

MCP本地开发

最小的本地 模型上下文协议（MCP） 用于AI辅助开发环境的服务器。 它允许你暴露你的 本地代码库, 配置文件，以及 参考文件 作为可通过以下工具访问的结构化资源 光标 或 VS代码AI.

🌱 概述

该项目旨在作为 模板 对于想要：

  • 快速创建本地MCP服务器。
  • 参考现有项目和最佳实践。
  • 为AI编码环境提供上下文数据。

它包括：

  • 基于STDIO的轻量级服务器。
  • 一个简单的TypeScript配置。
  • 示例资源目录支持。

🚀 快速开始

# Clone and install dependencies
git clone https://github.com/ilkergonenc/mcp-local-dev.git
cd mcp-local-dev
npm install

# Start development mode
npm run server:dev

🔗 连接中 mcp-local-dev 到光标和VS代码

您的本地MCP服务器可以连接到 两个光标 和 VS代码MCP扩展. 配置格式是相同的JSON结构，但它们存储在不同的位置。

🧩 对于 VS代码MCP扩展

创建（或更新） .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "mcp-local-dev": {
      "type": "stdio",
      "command": "node",
      "args": ["build/server.js"],
      "cwd": "${workspaceFolder}",
      "dev": {
        "watch": "build/**/*.js",
        "debug": { "type": "node" }
      }
    }
  }
}

VS代码使用 ${workspaceFolder} 自动地， 因此，无论您的本地目录路径如何，此设置都将正常工作。

💬 对于 光标IDE

打开 设置→ MCP服务器→ 添加服务器 并手动输入以下配置：

{
  "name": "mcp-local-dev",
  "type": "stdio",
  "command": "node",
  "args": ["build/server.js"],
  "cwd": "."
}

💡 在光标中， ${workspaceFolder} 不需要--使用 "cwd": "." 而是默认为项目根目录。

🧠 备注

  • 使用 build/server.js 稳定性版本（已编译）。

  • 如果您正在积极编辑MCP代码，可以临时切换到：

    "command": "npm",
"args": ["run", "server:dev"]

  • 一旦服务器启动，两种环境（游标和VSCode）都会自动检测到服务器，并列出可用的工具和资源。

📁 项目结构

mcp-local-dev/
│
├── src/
│   └── server.ts          # Main MCP server
│
├── resource/              # Place your reference files here
│   └── readme.md          # Example resource file
│
├── tsconfig.json
├── package.json
└── .gitignore

🧠 用例示例

您可以将此服务器连接到您的开发工具 并查询本地项目数据，如：

  • 技术栈摘要
  • 配置或依赖关系洞察
  • markdown文档中的最佳实践
  • 文件或文件夹级引用

⚖️ 许可证

麻省理工学院© 第一个Gönenc

相关 MCP