Universal Project MCP Server

通用项目 MCP 服务

一个简单的 MCP 服务，可让 Claude 连接到整个项目，不受上下文限制。Claude 可以探索整个代码库结构并读取所需的任何文件，但不会修改任何内容。

为什么要创建它

主要目的是让 Claude 能够全面了解项目结构，同时避免达到上下文限制。换句话说，尽可能高效地使用 Claude。无需复制粘贴代码片段，Claude 就可以：

• 一次查看整个项目结构
• 读取所需的任何文件，以了解代码
• 搜索多个文件，找到所需内容
• 搜索包含特定关键词的文件
• 全面了解项目的组织方式
• 即时分析项目类型、依赖项和关键文件

文件编辑功能怎么了？

我最初尝试添加完整的 CRUD 操作（创建、编辑、删除文件）和命令执行功能，但实际效果并不理想。Claude 会进行意料之外的更改，或运行我不希望执行的命令。因此，我移除了所有文件修改和命令执行功能。

现在它是只读的，效果要好得多——Claude 可以了解所有内容，而实际更改仍由你掌控。

可用方法

项目设置

• set_project_path(path) - 指定项目目录
• get_project_path() - 查看当前项目路径

智能项目分析

• get_project_summary() - 获取完整的项目概览（类型、README 文件、统计数据、复杂度）
• get_dependencies() - 分析配置文件中的所有项目依赖项
• find_entry_points() - 查找主文件、配置文件、路由及其他重要文件

探索项目

• get_structure(path, max_depth) - 获取完整的目录树
• list_directory(path) - 列出特定文件夹中的文件
• read_file(file_path, start_line, end_line) - 读取任意文件（可选指定行范围）
• get_file_info(file_path) - 获取文件详情和统计信息

查找内容

• search_files(pattern, path, include_content, file_extensions, max_results) - 按文件名或内容搜索文件

使用方法

1. 设置一次项目路径：告诉 Claude 项目所在位置
2. 让 Claude 即时分析：新的智能方法可帮助 Claude 立即了解项目
3. 获取针对性帮助：Claude 会聚焦于相关文件，并了解你的技术栈
4. 由你实现更改：Claude 会根据完整上下文给出精准建议

安装

cd coding-mcp-server
uv sync

Claude 配置

将以下内容添加到 Claude 桌面应用配置中：

{
  "mcpServers": {
    "universal-project": {
      "command": "uv",
      "args": ["run", "python", "D:\\path\\to\\your\\coding-mcp-server\\server_mcp.py"],
      "cwd": "D:\\path\\to\\your\\coding-mcp-server"
    }
  }
}

使用示例——前后对比

You: "Set my project to D:\MyFlutterApp"
Claude: *calls get_project_summary()*
"✓ This is a Flutter project with 156 files, medium complexity. 
Found README.md at root. Main directories: lib/, android/, ios/"

Claude: *calls get_dependencies()*  
"Uses 23 dependencies including http, provider, flutter_bloc"

Claude: *calls find_entry_points()*
"Main entry: lib/main.dart, Config: pubspec.yaml"

Claude: *reads README.md*
"I can see this is an e-commerce app with user authentication..."

Result: Claude understands your entire project in seconds!

主要优势

• 无上下文限制：Claude 可以查看整个项目，不受 Token 限制
• 即时分析：新方法可帮助 Claude 立即了解项目
• 智能聚焦：Claude 知道哪些文件值得阅读
• 了解技术栈：能够理解你的依赖项和项目类型
• 了解文档：自动查找并读取 README/文档
• 安全且只读：不会意外修改文件或执行命令

---