Developer Knowledge Graph MCP server for AI agents

The Developer MCP Server is a powerful context management system designed specifically for software development teams. It maintains persistent context across coding sessions, ensuring you never lose track of your project's structure, dependencies, and progress.

Installation Options

Using npx (Recommended)

The simplest way to run the Developer MCP Server is using npx:

npx github:tejpalvirk/contextmanager-developer

Customizing Data Storage Locations

You can customize where data is stored using environment variables:

# Store data in the current directory
MEMORY_FILE_PATH="./dev-memory.json" SESSIONS_FILE_PATH="./dev-sessions.json" npx github:tejpalvirk/contextmanager-developer

# Store data in a specific location (absolute path)
MEMORY_FILE_PATH="/path/to/data/developer-memory.json" npx github:tejpalvirk/contextmanager-developer

# Store data in user's home directory
MEMORY_FILE_PATH="$HOME/contextmanager/developer-memory.json" npx github:tejpalvirk/contextmanager-developer

Global Installation

For regular use, you might prefer to install the package globally:

npm install -g github:tejpalvirk/contextmanager/developer

# Then run it directly
contextmanager-developer

Docker Installation

You can also run the Developer MCP Server using Docker:

docker run --rm -i mcp/developer

Configuring with Claude Desktop

Option 1: Using npx

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "developer": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/developer"
      ]
    }
  }
}

Option 2: With Global Installation

If you've installed the package globally:

{
  "mcpServers": {
    "developer": {
      "command": "contextmanager-developer"
    }
  }
}

Option 3: With Docker

{
  "mcpServers": {
    "developer": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/developer"
      ]
    }
  }
}

Core Features

Persistent Development Context: Resume where you left off with complete context
Session Management: Record progress and updates when you finish
Dependency Tracking: Understand relationships between components
Project Status Insights: Get visibility into project progress
Component Context Retrieval: Understand any component's details
Decision History: Track architectural and implementation decisions
Milestone Progress Tracking: Monitor progress toward project goals
Related Entity Discovery: Find all related entities for comprehensive context

Available Tools

Starting and Ending Sessions

startsession: Begin a new development session with context about recent sessions, active projects, and priorities
endsession: Record achievements, task updates, and project status changes

Managing Context

loadcontext: Get detailed context for any entity (project, component, feature, etc.)
buildcontext: Create new entities or relationships
deletecontext: Remove entities or relationships
advancedcontext: Perform complex queries on the knowledge graph

Usage Examples

Starting a Session

"Start a new development session for me."

Loading Context

"Show me the current status of the AuthService project."
"Load the context for the UserProfile component."
"What are the open issues affecting the Payment feature?"
"Show me details about the upcoming Q2 Release milestone."

Recording Session Progress

"End my development session. I've been working on AuthService for 3 hours and completed user authentication flow implementation."
"Record my achievements for today: implemented password reset feature and fixed login redirect bug."
"Update the status of these tasks: Login Form is complete, User Registration is in progress."
"Create new tasks for the next sprint: Implement MFA, Add social login options."

Knowledge Graph Management

"Create a new feature called 'BillingSystem' in the ProjectX project."
"Create a relationship showing that PaymentComponent implements BillingSystem feature."
"Show me all components that depend on the DatabaseService."
"What decisions have been made about the authentication approach for ProjectX?"

Practical Use Cases

Context Continuity

"Let me see the component I was working on yesterday and all its dependencies."

Onboarding New Team Members

"Give me an overview of Project X's architecture and component structure."

Session Recording

"End my development session and record what I accomplished."

Architectural Decision Context

"Why was GraphQL chosen over REST for the API layer?"

Dependency Analysis

"What would be affected if we modify the authentication service?"

Project Progress Tracking

"What's our progress toward the Q2 release milestone?"

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "developer" '{"command":"npx","args":["-y","github:tejpalvirk/developer"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "developer": {
            "command": "npx",
            "args": [
                "-y",
                "github:tejpalvirk/developer"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "developer": {
            "command": "npx",
            "args": [
                "-y",
                "github:tejpalvirk/developer"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect