  
本地mcp启动器
一个完全通用的、环境变量驱动的 本地MCP服务器 这允许\ Cursor/ChatGPT桌面/Claude桌面（启用MCP的客户端）\ 安全地检查您机器上的任何本地项目。
该起动机设计用于：
- 🔧 项目无关 --适用于任何语言或框架
- 🔒 只读且安全 --没有对文件的写入权限
- ⚙️ 完全可配置，通过
.env - 🐳 在Docker内部运行 用于隔离
- 🔌 适用于Cursor/Claude桌面\
（ChatGPT桌面尚不支持本地MCP）
______________________________________________________________________
✨ 特性
✔ list_project_files(subdir=".")
递归返回指定子目录下的所有文件路径。
✔ read_project_file(path)
读取相对于项目根目录的文件内容。
______________________________________________________________________
📁 目录结构
local-mcp-starter/
│
├── Dockerfile
├── server.py
├── requirements.txt
├── .env.example
├── README.md
├── README_JP.md
└── LICENSE______________________________________________________________________
📦 安装
1.克隆存储库
cd ~
git clone https://github.com/M-Asan0/local-mcp-starter.git
cd local-mcp-starter______________________________________________________________________
2.创建您的 .env
所有用户特定的配置都在这里处理：
HOST_PROJECT_PATH=/home/yourname/your-project
CONTAINER_PROJECT_PATH=/workspace/target-project
PROJECT_ROOT=/workspace/target-project
MCP_SERVER_NAME=local-mcp-starter
MCP_IMAGE_NAME=local-mcp-starter______________________________________________________________________
3.构建Docker镜像
set -a
. .env
set +a
docker build -t ${MCP_IMAGE_NAME} .修改后重新生成 server.py 或Dockerfile。
______________________________________________________________________
4.🖥 MCP配置
假设您在$HOME/local mcp starter下克隆了仓库。如果使用其他位置，请相应地更新cd路径。
4-1.光标
安装说明
1.启动光标
打开光标编辑器。
2.打开设置面板
按 Shift + Ctrl + P 打开命令面板，\ 类型 settings，然后选择 光标设置.
3.打开“工具和MCP”部分
在设置窗口的左侧边栏中，选择 工具和MCP.
4.添加自定义MCP服务器
点击 添加自定义MCP 按钮。\ 这将打开您的 mcp.json 文件。
5.添加您的MCP配置
将以下配置粘贴到打开的文件中并保存：
Windwos/WSL
%USERPROFILE%\.cursor\mcp.json
{
"mcpServers": {
"local-mcp-starter": {
"command": "wsl",
"args": [
"bash",
"-lc",
"$HOME/local-mcp-starter/run-for-MCP-client.sh"
]
}
}
}macOS
~/.cursor/mcp.json
/.cursor/mcp.json
{
"mcpServers": {
"local-mcp-starter": {
"command": "bash",
"args": [
"-lc",
"$HOME/local-mcp-starter/run-for-MCP-client.sh"
]
}
}
}Linux
~/.cursor/mcp.json
/.cursor/mcp.json
{
"mcpServers": {
"local-mcp-starter": {
"command": "bash",
"args": [
"-lc",
"$HOME/local-mcp-starter/run-for-MCP-client.sh"
]
}
}
}4-2.克劳德桌面版
安装说明
1.启动克劳德桌面版
打开应用程序。
2.打开设置菜单
单击左上角的菜单并选择 设置.
3.打开“开发人员”部分
在设置窗口的左侧边栏中，选择 开发者.
4.打开配置文件
点击 编辑配置.\ 这将打开包含以下内容的文件夹 claude_desktop_config.json.
5.添加您的MCP配置
在JSON文件中粘贴并调整以下内容，然后保存：
6.重新启动桌面版的Claude
注意：只需单击“X”并不能完全退出应用程序。 在Windows上，使用任务管理器完全终止进程。 重新启动Claude for Desktop后，将重新加载配置。
7.验证MCP服务器是否已启用
返回聊天窗口。 在底部（“搜索和工具”），您应该看到列出了本地mcp启动器。 如果开关处于ON（绿色）状态，则MCP服务器已成功连接。
Windwos/WSL
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"local-mcp-starter": {
"command": "wsl",
"args": [
"bash",
"-lc",
"$HOME/local-mcp-starter/run-for-MCP-client.sh"
]
}
},
"isDxtAutoUpdatesEnabled": true,
"preferences": {
"menuBarEnabled": false,
"legacyQuickEntryEnabled": false
}
}macOS
/Users//Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"local-mcp-starter": {
"command": "bash",
"args": [
"-lc",
"$HOME/local-mcp-starter/run-for-MCP-client.sh"
]
}
},
"isDxtAutoUpdatesEnabled": true,
"preferences": {
"menuBarEnabled": false,
"legacyQuickEntryEnabled": false
}
}Linux
/home//.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"local-mcp-starter": {
"command": "bash",
"args": [
"-lc",
"$HOME/local-mcp-starter/run-for-MCP-client.sh"
]
}
}
}______________________________________________________________________
🧪 使用示例（光标）
列出文件
Run tool local-project-filesystem.list_project_files with {"subdir":"
"}读取文件
Run tool local-project-filesystem.read_project_file with {"path":"
"}要求AI使用MCP
If needed, use these MCP tools:
- local-project-filesystem.list_project_files
- local-project-filesystem.read_project_file
Investigate the issue and provide a fix.______________________________________________________________________
📝 许可证
MIT许可证\ 版权所有（c）2025