通用项目MCP服务器
一个简单的MCP服务器,让Claude连接到您的整个项目,不受上下文限制。Claude可以探索你的整个代码库结构并读取它需要的任何文件,但不会修改任何东西。
为什么存在
主要目的是让Claude完全了解您的项目结构,而不会受到上下文限制。换句话说,尽可能高效地使用claude。Claude可以:
- 一次查看整个项目结构
- 阅读理解代码所需的任何文件
- 搜索多个文件以查找所需内容
- 搜索包含特定关键字的文件
- 全面了解项目的组织方式
- 即时分析项目类型、依赖关系和关键文件
文件编辑怎么了?
我最初尝试添加完整的CRUD操作(创建、编辑、删除文件)和命令执行,但效果并不理想。克劳德会做出意想不到的改变,或者运行我不想运行的命令。因此,我删除了所有文件修改和命令执行功能。
现在它是只读的,效果更好——克劳德可以理解一切,但你可以控制实际的更改。
可用方法
项目设置
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)-按名称或内容搜索文件
如何使用它
- 设置项目一次:告诉克劳德你的项目在哪里
- 让克劳德立即分析:新的智能方法让Claude立即了解项目
- 获得有针对性的帮助:Claude专注于正确的文件,了解你的技术栈
- 您实施更改:克劳德根据完整的上下文给出了精确的建议
安装
cd coding-mcp-server
uv sync克劳德配置
将此添加到您的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看到你的整个项目没有令牌限制
- 即时分析:新方法可立即理解项目
- 智能焦点:Claude知道哪些文件很重要
- 技术栈感知:了解您的依赖关系和项目类型
- 文档意识:自动查找并阅读您的README/docs
- 安全且只读:没有意外的文件更改或命令执行
______________________________________________________________________

