Skip to main content
Glama
CodeLogic

CodeLogic

Official

Codelogic-MCP-Server

Ein MCP-Server zur Nutzung der umfangreichen Softwareabhängigkeitsdaten von Codelogic in Ihrem KI-Programmierassistenten.

Komponenten

Werkzeuge

Der Server implementiert zwei Tools:

  • codelogic-method-impact : Ruft eine Auswirkungsbewertung aus den APIs des CodeLogic-Servers für Ihren Code ab.

    • Nimmt die gegebene „Methode“, an der Sie arbeiten, und die zugehörige „Klasse“.

  • codelogic-database-impact : Analysiert Auswirkungen zwischen Code und Datenbankeinheiten.

    • Übernimmt den Datenbankentitätstyp (Spalte, Tabelle oder Ansicht) und seinen Namen.

Installieren

Voraussetzungen

Der MCP-Server ist auf Astral UV angewiesen. Bitte installieren Sie

MacOS-Workaround für uvx

Es gibt ein bekanntes Problem mit uvx unter MacOS , bei dem der CodeLogic MCP-Server in bestimmten IDEs (wie Cursor) möglicherweise nicht gestartet werden kann, was zu Fehlern wie diesen führt: Siehe Problem Nr. 11

Failed to connect client closed

Dies scheint ein Problem mit Astral uvx unter macOS zu sein. Folgendes kann als Workaround verwendet werden:

  1. Klonen Sie dieses Projekt lokal.

  2. Konfigurieren Sie Ihre mcp.json so, dass uv anstelle von uvx verwendet wird. Beispiel:

{
  "mcpServers": {
    "codelogic-mcp-server": {
      "type": "stdio",
      "command": "<PATH_TO_UV>/uv",
      "args": [
        "--directory",
        "<PATH_TO_THIS_REPO>/codelogic-mcp-server-main",
        "run",
        "codelogic-mcp-server"
      ],
      "env": {
        "CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
        "CODELOGIC_USERNAME": "<my username>",
        "CODELOGIC_PASSWORD": "<my password>",
        "CODELOGIC_MV_NAME": "<my workspace>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}
  1. Cursor neu starten.

  2. Stellen Sie sicher, dass die globale Cursorregel für CodeLogic vorhanden ist.

  3. Öffnen Sie die Registerkarte MCP im Cursor und aktualisieren Sie den codelogic-mcp-server .

  4. Bitten Sie Cursor, eine Codeänderung in einer vorhandenen Klasse vorzunehmen. Der MCP-Server sollte nun die Auswirkungsanalyse erfolgreich ausführen.

Related MCP server: NOMIK

Konfiguration für verschiedene IDEs

Visual Studio Code-Konfiguration

So konfigurieren Sie diesen MCP-Server in VS Code:

  1. Stellen Sie zunächst sicher, dass der GitHub Copilot-Agentmodus in VS Code aktiviert ist.

  2. Erstellen Sie in Ihrem Arbeitsbereich eine .vscode/mcp.json -Datei mit der folgenden Konfiguration:

{
  "servers": {
    "codelogic-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "codelogic-mcp-server@latest"
      ],
      "env": {
        "CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
        "CODELOGIC_USERNAME": "<my username>",
        "CODELOGIC_PASSWORD": "<my password>",
        "CODELOGIC_WORKSPACE_NAME": "<my workspace>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}

Hinweis: Auf manchen Systemen müssen Sie möglicherweise den vollständigen Pfad zur uvx-Programmdatei anstelle von „uvx“ verwenden. Beispiel: /home/user/.local/bin/uvx unter Linux/Mac oder C:\Users\username\AppData\Local\astral\uvx.exe unter Windows.

  1. Alternativ können Sie den Befehl MCP: Add Server aus der Befehlspalette ausführen und die Serverinformationen angeben.

  2. Verwenden Sie zum Verwalten Ihrer MCP-Server den Befehl MCP: List Servers aus der Befehlspalette.

  3. Nach der Konfiguration stehen die Server-Tools im Copilot-Agentenmodus zur Verfügung. Sie können bestimmte Tools nach Bedarf ein- und ausschalten, indem Sie im Agentenmodus in der Chat-Ansicht auf die Schaltfläche „Tools“ klicken.

  4. Um die Codelogic-Tools im Agentenmodus zu verwenden, können Sie gezielt nach Codeauswirkungen oder Datenbankbeziehungen fragen, und der Agent verwendet die entsprechenden Tools.

Claude Desktop-Konfiguration

Konfigurieren Sie Claude Desktop, indem Sie die Konfigurationsdatei bearbeiten:

  • Unter MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  • Unter Windows: %APPDATA%/Claude/claude_desktop_config.json

  • Unter Linux: ~/.config/Claude/claude_desktop_config.json

Fügen Sie Ihrer Konfigurationsdatei Folgendes hinzu:

"mcpServers": {
  "codelogic-mcp-server": {
    "command": "uvx",
    "args": [
      "codelogic-mcp-server@latest"
    ],
    "env": {
      "CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<my username>",
      "CODELOGIC_PASSWORD": "<my password>",
      "CODELOGIC_WORKSPACE_NAME": "<my workspace>"
    }
  }
}

Hinweis: Auf manchen Systemen müssen Sie möglicherweise den vollständigen Pfad zur uvx-Programmdatei anstelle von „uvx“ verwenden. Beispiel: /home/user/.local/bin/uvx unter Linux/Mac oder C:\Users\username\AppData\Local\astral\uvx.exe unter Windows.

Starten Sie Claude Desktop nach dem Hinzufügen der Konfiguration neu, um die Änderungen zu übernehmen.

Windsurf IDE-Konfiguration

So führen Sie diesen MCP-Server mit Windsurf IDE aus:

Windsurf IDE konfigurieren :

Um Windsurf IDE zu konfigurieren, müssen Sie die Konfigurationsdatei ~/.codeium/windsurf/mcp_config.json erstellen oder ändern.

Fügen Sie Ihrer Datei die folgende Konfiguration hinzu:

"mcpServers": {
  "codelogic-mcp-server": {
    "command": "uvx",
    "args": [
      "codelogic-mcp-server@latest"
    ],
    "env": {
      "CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<my username>",
      "CODELOGIC_PASSWORD": "<my password>",
      "CODELOGIC_WORKSPACE_NAME": "<my workspace>"
    }
  }
}

Hinweis: Auf manchen Systemen müssen Sie möglicherweise den vollständigen Pfad zur uvx-Programmdatei anstelle von „uvx“ verwenden. Beispiel: /home/user/.local/bin/uvx unter Linux/Mac oder C:\Users\username\AppData\Local\astral\uvx.exe unter Windows.

Starten Sie Windsurf IDE nach dem Hinzufügen der Konfiguration neu oder aktualisieren Sie die Tools, um die Änderungen anzuwenden.

Cursorkonfiguration

So konfigurieren Sie den CodeLogic MCP-Server in Cursor:

  1. Konfigurieren Sie den MCP-Server, indem Sie eine .cursor/mcp.json Datei erstellen:

{
  "mcpServers": {
    "codelogic-mcp-server": {
      "command": "uvx",
      "args": [
        "codelogic-mcp-server@latest"
      ],
      "env": {
        "CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
        "CODELOGIC_USERNAME": "<my username>",
        "CODELOGIC_PASSWORD": "<my password>",
        "CODELOGIC_WORKSPACE_NAME": "<my workspace>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}

Hinweis: Auf manchen Systemen müssen Sie möglicherweise den vollständigen Pfad zur uvx-Programmdatei anstelle von „uvx“ verwenden. Beispiel: /home/user/.local/bin/uvx unter Linux/Mac oder C:\Users\username\AppData\Local\astral\uvx.exe unter Windows.

  1. Starten Sie Cursor neu, um die Änderungen zu übernehmen.

Die CodeLogic MCP-Servertools sind jetzt in Ihrem Cursor-Arbeitsbereich verfügbar.

Anweisungen/Regeln für den KI-Assistenten

Damit der KI-Assistent die CodeLogic-Tools effektiv nutzen kann, können Sie die folgenden Anweisungen/Regeln zur Konfiguration Ihres Clients hinzufügen. Wir empfehlen, diese Anweisungen an die spezifischen Codierungsstandards, Best Practices und Workflow-Anforderungen Ihres Teams anzupassen:

VS Code (GitHub Copilot) Anweisungen

Erstellen Sie eine .vscode/copilot-instructions.md -Datei mit folgendem Inhalt:

# CodeLogic MCP Server Instructions

When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods

When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities

To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts

Claude Desktop-Anweisungen

Erstellen Sie eine Datei ~/.claude/instructions.md mit folgendem Inhalt:

# CodeLogic MCP Server Instructions

When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods

When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities

To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts

Windsurf IDE Regeln

Erstellen oder ändern Sie die Markdown-Datei ~/.codeium/windsurf/memories/global_rules.md mit dem folgenden Inhalt:

When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods

When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities

To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts

Globale Cursorregel

So konfigurieren Sie CodeLogic-Regeln in Cursor:

  1. Cursoreinstellungen öffnen

  2. Navigieren Sie zum Abschnitt „Regeln“

  3. Fügen Sie den „Benutzerregeln“ den folgenden Inhalt hinzu:

# CodeLogic MCP Server Rules
## Codebase
- The CodeLogic MCP Server is for java, javascript, typescript, and C# dotnet codebases
- don't run the tools on python or other non supported codebases
## AI Assistant Behavior
- When modifying existing code methods:
  - Use codelogic-method-impact to analyze code changes
  - Use codelogic-database-impact for database modifications
  - Highlight impact results for the modified methods
- When modifying SQL code or database entities:
  - Always use codelogic-database-impact to analyze potential impacts
  - Highlight impact results for the modified database entities
- To use the CodeLogic tools effectively:
  - For code impacts: Ask about specific methods or functions
  - For database relationships: Ask about tables, views, or columns
  - Review the impact results before making changes
  - Consider both direct and indirect impacts

Umgebungsvariablen

Die folgenden Umgebungsvariablen können konfiguriert werden, um das Verhalten des Servers anzupassen:

  • CODELOGIC_SERVER_HOST : Die URL des CodeLogic-Servers.

  • CODELOGIC_USERNAME : Ihr CodeLogic-Benutzername.

  • CODELOGIC_PASSWORD : Ihr CodeLogic-Passwort.

  • CODELOGIC_WORKSPACE_NAME : Der Name des zu verwendenden Arbeitsbereichs.

  • CODELOGIC_DEBUG_MODE : Auf true setzen, um den Debug-Modus zu aktivieren. Wenn aktiviert, werden zusätzliche Debug-Dateien wie timing_log.txt und impact_data*.json generiert. Standardmäßig auf false gesetzt.

Beispielkonfiguration

"env": {
  "CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
  "CODELOGIC_USERNAME": "<my username>",
  "CODELOGIC_PASSWORD": "<my password>",
  "CODELOGIC_WORKSPACE_NAME": "<my workspace>",
  "CODELOGIC_DEBUG_MODE": "true"
}

Fixieren der Version

Anstatt die neueste Version des Servers zu verwenden, können Sie eine bestimmte Version festlegen, indem Sie das Argumentfeld so ändern, dass es der Version in pypi entspricht, z. B.

    "args": [
      "codelogic-mcp-server@0.2.2"
    ],

Versionskompatibilität

Für diesen MCP-Server gelten die folgenden Versionskompatibilitätsanforderungen:

  • Version 0.3.1 und darunter: Kompatibel mit allen CodeLogic API-Versionen

  • Version 0.4.0 und höher: Erfordert CodeLogic API Version 25.10.0 oder höher

Stellen Sie beim Upgrade sicher, dass Ihr CodeLogic-Server die Mindestanforderungen an die API-Version erfüllt.

Testen

Ausführen von Unit-Tests

Das Projekt verwendet unittest zum Testen. Sie können Unit-Tests ohne externe Abhängigkeiten ausführen:

python -m unittest discover -s test -p "unit_*.py"

Unit-Tests verwenden simulierte Daten und erfordern keine Verbindung zu einem CodeLogic-Server.

Integrationstests (optional)

Wenn Sie Integrationstests ausführen möchten, die eine Verbindung zu einem echten CodeLogic-Server herstellen:

  1. Kopieren Sie test/.env.test.example nach test/.env.test und füllen Sie es mit Ihren CodeLogic-Serverdetails

  2. Führen Sie die Integrationstests aus:

python -m unittest discover -s test -p "integration_*.py"

Hinweis: Integrationstests erfordern Zugriff auf eine CodeLogic-Serverinstanz.

Available Tools

8 tools
codelogic-database-impactA

Analyze impacts between code and database entities. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:

  1. Use this tool before implementing code or database changes

  2. Search for the relevant database entity

  3. Review the impact analysis to understand which code depends on this database object and vice versa Particularly crucial when AI-suggested modifications are being considered or when modifying SQL code.

Inputs: name (required), entity_type (required), table_or_view.

codelogic-graph-capabilitiesA

Fetch graph API capabilities/manifest from the CodeLogic server (GET). Returns label and relationship metadata when the graph tier is deployed; otherwise explains missing routes. Uses CODELOGIC_WORKSPACE_NAME for MV id unless materialized_view_id is set.

Inputs: materialized_view_id.

codelogic-graph-impactC

Bounded graph impact from seed node ids (curated HTTP API). Optional direction (upstream|downstream|both), depth, scan_space, materialized_view_id.

Inputs: seed_node_ids (required), depth, direction, scan_space, +1 more.

codelogic-graph-ownersB

Look up owners/reviewers for a graph node (curated HTTP API). Provide node_id or identity_prefix.

Inputs: node_id, scan_space, identity_prefix, materialized_view_id.

codelogic-graph-path-explainA

Explain bounded paths between two graph nodes (curated HTTP API). Requires from_node_id, to_node_id; optional max_depth, scan_space, materialized_view_id.

Inputs: to_node_id (required), from_node_id (required), max_depth, scan_space, +1 more.

codelogic-graph-validate-change-scopeC

Validate whether a proposed change scope is safe given seed graph nodes (curated HTTP API).

Inputs: seed_node_ids (required), proposed_change_summary (required), scan_space, materialized_view_id.

codelogic-method-impactA

Analyze impacts of modifying a specific method within a given class or type. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:

  1. Use this tool before implementing code changes

  2. Run the tool against methods or functions that are being modified

  3. Carefully review the impact analysis results to understand potential downstream effects Particularly crucial when AI-suggested modifications are being considered.

Inputs: class (required), method (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation4/5

    The tools are largely distinct: method-impact and database-impact target specific impact scenarios, while the graph-* tools handle search, traversal, path explanation, validation, and ownership lookup. There is minor potential confusion between graph-impact and graph-validate-change-scope since both analyze change effects, but their descriptions clarify different entry points.

    Naming Consistency4/5

    All tools share a consistent codelogic- prefix and hyphenated convention, making the family recognizable. However, the second segment mixes styles: some are noun phrases (graph-capabilities, graph-owners) and others are verb-oriented (graph-search, graph-path-explain), so the pattern is not fully uniform.

    Tool Count5/5

    Eight tools is well-scoped for a CodeLogic analysis server: two domain-specific impact analyzers, one general graph impact/search pair, plus metadata/owners lookups. Each tool covers a distinct capability without redundancy.

    Completeness5/5

    The surface covers the core workflows: impact analysis by method, database entity, and generic graph traversal, plus search, path explanation, ownership lookup, and capability discovery. This is a coherent analysis-focused API with lifecycle operations not needed for the domain.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Transforms code repositories and development documentation into a queryable Neo4j knowledge graph, enabling AI assistants to perform intelligent code analysis, dependency mapping, impact assessment, and automated documentation generation across 15+ programming languages.
      7
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-native code intelligence graph that builds a persistent knowledge graph of your codebase in Neo4j and exposes it to AI assistants via MCP, enabling contextual code analysis, impact analysis, and dependency tracking.
      23
      MIT