Universal Project MCP Server

Name: Universal Project MCP Server
Author: riskiilyas

@riskiilyas

代码仓库

关于 Universal Project MCP Server

MCP Server for my Claude to understand a whole project

#mcp-server #project-analysis #claude-assistant

基本信息

分类

其他

运行时

python

传输方式

stdio

发布者

riskiilyas

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "Project-MCP-Server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Universal Project MCP Server?

A read-only MCP server that lets Claude connect to your entire project without context limitations. It gives Claude full access to understand project structure and read any file, but will not modify anything. Designed for developers to get context-aware assistance without copying code snippets.

How to use Universal Project MCP Server?

Install with uv sync in the coding-mcp-server directory, then add a configuration entry to your Claude Desktop app pointing to server_mcp.py. Use the set_project_path(path) method to point to your project, then Claude can use methods like get_project_summary(), get_dependencies(), read_file(), search_files(), etc.

Key features of Universal Project MCP Server

Set project path and get real-time project overview
Analyze project type, dependencies, and entry points instantly
Browse directory structure with adjustable depth
Read any file with optional line range
Search files by name or content with filters
Safe read-only access — no file modification or command execution

Use cases of Universal Project MCP Server

Claude understands your codebase structure and dependencies in seconds
Get targeted help on specific files without copying code into chat
Quickly locate files by name or content across the project
Analyze project complexity and entry points for onboarding or debugging
Safe exploration without risk of unintended changes

FAQ from Universal Project MCP Server

Is the server read-only?

Yes, all file modification and command execution features have been removed. Claude can read and understand your project but cannot change files or run commands.

How do I install and configure it?

Clone the repository, run uv sync in the coding-mcp-server folder, then add the provided JSON configuration to your Claude Desktop app's mcpServers section. The command should be uv run python <path to server_mcp.py>.

Does it support any programming language or project type?

Yes, it works with any project type. The server analyzes files like README, configuration files, and source files to determine project type and dependencies.

What methods are available?

Methods include set_project_path, get_project_path, get_project_summary, get_dependencies, find_entry_points, get_structure, list_directory, read_file, get_file_info, and search_files. All are documented in the README.