lineai-mcp-server 1.3.1__tar.gz

lineai_mcp_server-1.3.1/.cursor/rules/about-codebase.mdc

@@ -0,0 +1,9 @@
+---
+description: General information about the Lineai MCP Server codebase and its purpose
+globs: 
+alwaysApply: false
+---
+- This repository contains a Model Context Protocol (MCP) server that integrates with Lineai's knowledge graph APIs
+- It enables AI programming assistants to access dependency data from Lineai to analyze code and database impacts
+- Tools: `lineai-method-impact`, `lineai-database-impact`, and `lineai-graph-*` (capabilities, search, impact, path-explain, validate-change-scope, owners)
+- The core package is in `src/lineai_mcp_server/` with `server.py`, `handlers/` (package), and `utils.py`

lineai_mcp_server-1.3.1/.cursor/rules/best-practices.mdc

@@ -0,0 +1,10 @@
+---
+description: Best practices for working with the Lineai MCP Server codebase
+globs: 
+alwaysApply: false
+---
+- Use semantic search before grep for broader context
+- Maintain proper error handling and logging
+- Keep code changes atomic and focused
+- Prefer graph tools (`lineai-graph-*`) for discovery when available; fall back to method/database impact tools
+- Return results as clear markdown for AI assistants

lineai_mcp_server-1.3.1/.cursor/rules/debugging.mdc

@@ -0,0 +1,9 @@
+---
+description: Debugging guidance for the Lineai MCP Server
+globs: "**/*.py"
+alwaysApply: false
+---
+- Enable Debug Mode by setting `LINEAI_DEBUG_MODE=true`
+- Use debugpy capabilities for remote debugging
+- Check logs in the logs directory for detailed information
+- Use proper logging levels for different types of information

lineai_mcp_server-1.3.1/.cursor/rules/environment-variables.mdc

@@ -0,0 +1,11 @@
+---
+description: Key environment variables for the Lineai MCP Server
+globs: "**/*.py"
+alwaysApply: false
+---
+- `LINEAI_SERVER_HOST`: Lineai server URL
+- `LINEAI_USERNAME`: Username for authentication
+- `LINEAI_PASSWORD`: Password for authentication
+- `LINEAI_WORKSPACE_NAME`: Workspace name
+- `LINEAI_DEBUG_MODE`: Enable debug logging
+- `LINEAI_TEST_MODE`: Used by test framework

lineai_mcp_server-1.3.1/.cursor/rules/error-handling.mdc

@@ -0,0 +1,18 @@
+---
+description: Error handling patterns for the Lineai MCP Server
+globs: "**/*.py"
+alwaysApply: false
+---
+# Use the following pattern for error handling in tool implementations
+
+```python
+try:
+    # Operations that might fail
+except Exception as e:
+    sys.stderr.write(f"Error: {str(e)}\n")
+    return [types.TextContent(type="text", text=f"# Error\n\n{str(e)}")]
+```
+
+- Always catch and report exceptions
+- Write errors to stderr
+- Return formatted error messages to the client

lineai_mcp_server-1.3.1/.cursor/rules/mcp-server-pattern.mdc

@@ -0,0 +1,24 @@
+---
+description: Core coding patterns for MCP Server implementation
+globs: "**/*.py"
+alwaysApply: false
+---
+
+# Use the following pattern for MCP server implementation
+
+```python
+server = Server("lineai-mcp-server")
+
+@server.list_tools()
+async def handle_list_tools() -> list[types.Tool]:
+    # Define and return tools
+    
+@server.call_tool()
+async def handle_call_tool(name: str, arguments: dict | None) -> list[types.TextContent]:
+    # Handle tool execution
+```
+
+- New tools should be added to `handlers/__init__.py` `handle_list_tools()` with descriptive names (prefix: `lineai-`)
+- Tool handlers should be routed in `handle_call_tool()`
+- Create handler functions with proper error handling
+- Return results as markdown-formatted text

lineai_mcp_server-1.3.1/.cursor/rules/style-guidelines.mdc

@@ -0,0 +1,10 @@
+---
+description: Style guidelines for the Lineai MCP Server project
+globs: "**/*.py"
+alwaysApply: false
+---
+- Include MPL 2.0 copyright headers in all Python files
+- Use Google-style docstrings for modules/classes/functions
+- Always use Python type hints
+- Keep I/O operations asynchronous
+- Return markdown-formatted text in tool responses

lineai_mcp_server-1.3.1/.cursor/rules/technologies.mdc

@@ -0,0 +1,10 @@
+---
+description: Key technologies used in the Lineai MCP Server project
+globs: 
+alwaysApply: false
+---
+- Python 3.13+ with extensive use of async/await
+- Model Context Protocol SDK (`mcp[cli]`)
+- HTTPX for API requests
+- Environment variables via dotenv for configuration
+- Lineai graph HTTP API under `/ai-retrieval/graph/` for `lineai-graph-*` tools

lineai_mcp_server-1.3.1/.cursor/rules/testing-approach.mdc

@@ -0,0 +1,9 @@
+---
+description: Testing approach for the Lineai MCP Server
+globs: "**/test/*.py"
+alwaysApply: false
+---
+- Use unit tests for functions without external dependencies
+- Use integration tests for tests against a real Lineai server
+- Set the `LINEAI_TEST_MODE` environment variable for test runs
+- Test both success cases and error handling patterns

lineai_mcp_server-1.3.1/.flake8

@@ -0,0 +1,3 @@
+    [flake8]
+    ignore = E501, W503
+    max-line-length = 120

lineai_mcp_server-1.3.1/.github/ISSUE_TEMPLATE/Bug-Report.yml

@@ -0,0 +1,102 @@
+name: Bug Report
+description: File a bug report
+title: "[Bug]: "
+labels: ["bug"]
+type: Bug
+assignees:
+  - garrmark
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Tell us what happened...
+    validations:
+      required: true
+      
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: Steps To Reproduce
+      description: |
+        Steps to reproduce the behavior:
+        1. API endpoint accessed (e.g., '/v1/generate')
+        2. Request payload used (please include relevant JSON)
+        3. Client configuration (e.g., authentication method, headers)
+        4. Model configuration parameters (if applicable)
+        5. Observed error or unexpected behavior
+      placeholder: Provide detailed steps so we can reproduce the issue...
+    validations:
+      required: true
+      
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+    validations:
+      required: true
+      
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: If applicable, add screenshots to help explain your problem.
+      
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      multiple: true
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - Other (specify in additional context)
+    validations:
+      required: true
+      
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      placeholder: e.g., 3.9.10
+    validations:
+      required: true
+      
+  - type: input
+    id: package-version
+    attributes:
+      label: Package Version
+      placeholder: e.g., 1.0.0
+    validations:
+      required: true
+      
+  - type: input
+    id: client-implementation
+    attributes:
+      label: Client Implementation
+      description: How are you accessing the service?
+      placeholder: e.g., Python SDK, curl, etc.
+    validations:
+      required: true
+      
+  - type: input
+    id: models
+    attributes:
+      label: Model(s) Used
+      placeholder: e.g., specific model versions being used
+    validations:
+      required: true
+      
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here.

lineai_mcp_server-1.3.1/.github/ISSUE_TEMPLATE/Feature-Request.yml

@@ -0,0 +1,57 @@
+name: Feature Request
+description: Suggest an idea for this project
+title: "[Feature]: "
+labels: ["enhancement"]
+type: Feature
+assignees:
+  - garrmark
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to suggest a new feature!
+  
+  - type: textarea
+    id: problem-description
+    attributes:
+      label: Is your feature request related to a problem?
+      description: A clear and concise description of what the problem is.
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+      
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+      
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+    validations:
+      required: false
+      
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+    validations:
+      required: false
+      
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Nice to have
+        - Important
+        - Critical
+    validations:
+      required: true

lineai_mcp_server-1.3.1/.github/copilot-instructions.md

@@ -0,0 +1,99 @@
+# Lineai MCP Server - AI Assistant Instructions
+
+## About This Codebase
+
+This repository contains a Model Context Protocol (MCP) server that integrates with Lineai's knowledge graph APIs. It enables AI programming assistants (like GitHub Copilot and Cursor) to access dependency data from Lineai to analyze code and database impacts.
+
+## Key Technologies
+
+- **Python 3.13+** with extensive use of async/await
+- **Model Context Protocol SDK** (`mcp[cli]`)
+- **Neo4j** for graph database operations
+- **HTTPX** for API requests
+- **Environment variables** via dotenv for configuration
+
+## Project Structure
+
+- **src/lineai_mcp_server/**: Core package
+- **`__init__.py`**: Package initialization and entry point  
+- **`server.py`**: MCP server implementation  
+- **`handlers.py`**: Tool handlers implementation  
+- **`utils.py`**: API interaction utilities  
+
+## Core Coding Patterns
+
+### MCP Server Pattern
+
+```python
+server = Server("lineai-mcp-server")
+
+@server.list_tools()
+async def handle_list_tools() -> list[types.Tool]:
+    # Define and return tools
+    
+@server.call_tool()
+async def handle_call_tool(name: str, arguments: dict | None) -> list[types.TextContent]:
+    # Handle tool execution
+```
+
+### Error Handling
+
+```python
+try:
+    # Operations that might fail
+except Exception as e:
+    sys.stderr.write(f"Error: {str(e)}\n")
+    return [types.TextContent(type="text", text=f"# Error\n\n{str(e)}")]
+```
+
+## Style Guidelines
+
+1. **Copyright Headers**: Include MPL 2.0 headers in all Python files
+2. **Docstrings**: Google-style docstrings for modules/classes/functions
+3. **Type Hints**: Always use Python type hints
+4. **Asynchronous**: Keep I/O operations asynchronous
+5. **Format Outputs**: Return markdown-formatted text in tool responses
+
+## Tool Implementation Pattern
+
+When implementing new MCP tools:
+
+1. Add to `handle_list_tools()` with descriptive name (prefix: `lineai-`)
+2. Add handler in `handle_call_tool()`
+3. Implement handler function with error handling
+4. Return results as markdown-formatted text
+
+## Testing Approach
+
+- **Unit Tests**: For functions without external dependencies
+- **Integration Tests**: For tests against a real Lineai server
+- Use the `LINEAI_TEST_MODE` environment variable
+
+## Debugging
+
+- Debug Mode: Set `LINEAI_DEBUG_MODE=true`
+- Remote Debugging: Use debugpy capabilities
+
+## Key Environment Variables
+
+- `LINEAI_SERVER_HOST`: Lineai server URL
+- `LINEAI_USERNAME`: Username for authentication
+- `LINEAI_PASSWORD`: Password for authentication
+- `LINEAI_WORKSPACE_NAME`: Workspace name
+- `LINEAI_DEBUG_MODE`: Enable debug logging
+- `LINEAI_TEST_MODE`: Used by test framework
+
+## AI Assistant Integration
+
+### GitHub Copilot
+- Uses these instructions via `.github/copilot-instructions.md`
+- Integrates through GitHub's Copilot infrastructure
+
+### Cursor
+- Uses these instructions via `.cursor/instructions.md`
+- Integrates through Cursor's AI infrastructure
+- Supports additional features like:
+  - Direct file editing
+  - Terminal command execution
+  - Code search and analysis
+  - Database impact analysis

lineai_mcp_server-1.3.1/.github/release.yml

@@ -0,0 +1,23 @@
+# .github/release.yml
+
+changelog:
+  categories:
+    - title: New Features
+      labels:
+        - enhancement
+        - feature
+    - title: Bug Fixes
+      labels:
+        - bug
+        - fix
+    - title: Documentation
+      labels:
+        - documentation
+        - docs
+    - title: Dependencies
+      labels:
+        - dependencies
+        - dependency
+    - title: Other Changes
+      labels:
+        - '*'

lineai_mcp_server-1.3.1/.github/workflows/bump-version.yml

@@ -0,0 +1,195 @@
+name: Bump Version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_type:
+        description: 'Type of version bump (patch, minor, major)'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+      custom_version:
+        description: 'Custom version (optional, overrides version_type if provided)'
+        required: false
+        type: string
+      release_notes:
+        description: 'Release notes for this version'
+        required: false
+        type: string
+
+jobs:
+  bump-version:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    permissions:
+      contents: write
+    outputs:
+      new_version: ${{ steps.bump_version.outputs.new_version }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+          
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.14'
+          
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install toml
+          
+      - name: Configure Git
+        run: |
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+          
+      - name: Bump version
+        id: bump_version
+        run: |
+          python -c '
+          import toml
+          import sys
+          import re
+          import os
+          import json
+          
+          # Read the current version
+          with open("pyproject.toml", "r") as f:
+              config = toml.load(f)
+              
+          current_version = config["project"]["version"]
+          print(f"Current version: {current_version}")
+          
+          # Parse the current version
+          major, minor, patch = map(int, current_version.split("."))
+          
+          # Determine the new version
+          custom_version = "${{ github.event.inputs.custom_version }}"
+          if custom_version:
+              # Validate custom version format
+              if re.match(r"^\d+\.\d+\.\d+$", custom_version):
+                  new_version = custom_version
+              else:
+                  print("Error: Custom version must be in format X.Y.Z")
+                  sys.exit(1)
+          else:
+              version_type = "${{ github.event.inputs.version_type }}"
+              if version_type == "patch":
+                  patch += 1
+              elif version_type == "minor":
+                  minor += 1
+                  patch = 0
+              elif version_type == "major":
+                  major += 1
+                  minor = 0
+                  patch = 0
+              else:
+                  print(f"Error: Unknown version type: {version_type}")
+                  sys.exit(1)
+                  
+              new_version = f"{major}.{minor}.{patch}"
+          
+          # Update the version in pyproject.toml
+          config["project"]["version"] = new_version
+          with open("pyproject.toml", "w") as f:
+              toml.dump(config, f)
+              
+          # Update the version in server.json (both top-level and packages[].version)
+          try:
+              with open("server.json", "r") as f:
+                  server_config = json.load(f)
+              server_config["version"] = new_version
+              if isinstance(server_config.get("packages"), list):
+                  for pkg in server_config["packages"]:
+                      if isinstance(pkg, dict) and "version" in pkg:
+                          pkg["version"] = new_version
+              with open("server.json", "w") as f:
+                  json.dump(server_config, f, indent=2)
+                  f.write("\n")
+          except FileNotFoundError:
+              print("Warning: server.json not found; skipping update")
+
+          print(f"New version: {new_version}")
+          with open(os.environ["GITHUB_OUTPUT"], "a") as f:
+              f.write(f"new_version={new_version}\n")
+          '
+          
+      - name: Commit and push changes
+        run: |
+          git add pyproject.toml server.json
+          git commit -m "Bump version to ${{ steps.bump_version.outputs.new_version }}"
+          git push
+          
+      - name: Create tag
+        run: |
+          git tag v${{ steps.bump_version.outputs.new_version }}
+          git push --tags
+
+  create-release:
+    needs: bump-version
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        with:
+          fetch-depth: 0
+      
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@718ea10b132b3b2eba29c1007bb80653f286566b # v3
+        with:
+          tag_name: v${{ needs.bump-version.outputs.new_version }}
+          name: Release v${{ needs.bump-version.outputs.new_version }}
+          body: ${{ github.event.inputs.release_notes || '' }}
+          generate_release_notes: ${{ github.event.inputs.release_notes == '' }}
+          draft: false
+          prerelease: false
+          token: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Notify Teams about new version
+        env:
+          TEAMS_WEBHOOK_URL: ${{ secrets.TEAMS_WEBHOOK_URL }}
+          VERSION: ${{ needs.bump-version.outputs.new_version }}
+          ACTOR: ${{ github.actor }}
+          NOTES: ${{ github.event.inputs.release_notes || 'No release notes provided.' }}
+          RELEASE_URL: ${{ github.server_url }}/${{ github.repository }}/releases/tag/v${{ needs.bump-version.outputs.new_version }}
+        run: |
+          jq -n \
+            --arg version "$VERSION" \
+            --arg actor "$ACTOR" \
+            --arg notes "$NOTES" \
+            --arg release_url "$RELEASE_URL" \
+            '{
+              type: "message",
+              attachments: [{
+                contentType: "application/vnd.microsoft.card.adaptive",
+                contentUrl: null,
+                content: {
+                  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
+                  type: "AdaptiveCard",
+                  version: "1.4",
+                  body: [
+                    { type: "TextBlock", weight: "Bolder", size: "Medium", text: "New Version Released" },
+                    { type: "FactSet", facts: [
+                      { title: "Package", value: ("lineai-mcp-server v" + $version) },
+                      { title: "Released by", value: $actor }
+                    ]},
+                    { type: "TextBlock", text: $notes, wrap: true }
+                  ],
+                  actions: [{
+                    type: "Action.OpenUrl",
+                    title: "View Release on GitHub",
+                    url: $release_url
+                  }]
+                }
+              }]
+            }' | curl -fsS -X POST -H 'Content-Type: application/json' \
+                 -d @- "$TEAMS_WEBHOOK_URL"

lineai_mcp_server-1.3.1/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.13]
+
+    steps:
+    - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      env:
+        PIP_PROGRESS_BAR: off
+      run: |
+        python -m pip install --upgrade pip -q
+        python -m pip install uv -q
+        uv pip install --system -e ".[dev]" --quiet
+        python -m pip install flake8 -q
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings (quiet: only violations, no per-file stats)
+        flake8 . --count --exit-zero --max-complexity=10 --quiet
+    - name: Test with unittest
+      run: |
+        python -m unittest discover -s test -p "unit*.py"