mcp -codegraph

The mcp-codegraph server is designed to provide a comprehensive graph representation of your codebase, enabling developers to visualize relationships among files, functions, and variables. By leveraging the Model Context Protocol (MCP), this server allows you to better understand the structure of your code, making it easier to navigate and optimize complex projects. You can utilize this tool to enhance code comprehension, facilitate debugging, and improve collaboration within development teams.

Once you are connected to the mcp-codegraph server, you can interact with it by sending queries to generate visual representations of your codebase. While specific tools are not documented yet, you can run queries that request information on file dependencies, function calls, and variable scopes. For best results, structure your queries to focus on specific files or modules to get detailed insights tailored to your needs.

Prerequisites

To install the mcp-codegraph server, ensure you have Node.js installed on your machine. You can check if you have Node.js by running:

node -v

Option A: Quick start with npx

If you prefer to quickly test the server, you can use the following command:

npx -y @CartographAI/mcp-server-codegraph

Option B: Global install alternative

For a global installation, you can clone the repository and install the dependencies manually:

git clone https://github.com/CartographAI/mcp-server-codegraph.git
cd mcp-server-codegraph
npm install
npm start

When configuring the mcp-codegraph server, ensure that your environment variables are set correctly to point to your codebase. A common gotcha is failing to provide the correct path for the code directory, which can lead to incomplete graph representations. Keep an eye on the server logs for any errors related to file access or parsing issues.