Skip to main content

Error Repository MCP Server

An MCP (Model Context Protocol) server that provides access to an error database stored in Excel format. This server can answer questions about error codes, descriptions, and provide probable solutions for various types of technical errors.

Features

  • Error Code Lookup: Search for specific errors by their error codes (e.g., E001, DB001, NET001)
  • Description Search: Find errors by searching through error descriptions and types
  • Category Filtering: Browse errors by categories (Programming, Database, Network, Security, System)
  • Error Summary: Get statistics and overview of the error database
  • Excel Database: Easily maintainable error repository in Excel format

Error Database

The server includes a comprehensive error database with:

  • Programming Errors: Syntax errors, reference errors, type errors
  • Database Errors: Connection issues, SQL syntax problems, schema errors
  • Network Errors: Timeouts, HTTP errors, connectivity issues
  • Security Errors: Authentication and authorization problems
  • System Errors: Memory issues, disk space problems

Each error entry includes:

  • Error code (unique identifier)
  • Error type and description
  • Severity level
  • Category
  • Detailed solution steps
  • Code examples
  • Related error references

Installation

pip install error-repository-server

From Source

  1. Clone this repository:
    git clone https://github.com/yourusername/error-repository-server.git
    cd error-repository-server
    
  2. Install dependencies:
    pip install -e .
    

Usage

Running the Server

To run the MCP server directly:

python -m error_repository_server.server

Configuration for MCP Clients

Add this to your MCP client configuration:

For Claude Desktop:

{
  "mcpServers": {
    "error-repository": {
      "command": "python",
      "args": ["-m", "error_repository_server.server"]
    }
  }
}

For other MCP clients:

{
  "name": "error-repository-server",
  "command": "python",
  "args": ["-m", "error_repository_server.server"],
  "env": {}
}

Available Tools

The server provides the following tools:

  1. search_error_by_code: Find a specific error by its code

    • Input: error_code (string)
    • Example: "E001", "DB001", "NET001"
  2. search_error_by_description: Search errors by keywords

    • Input: description (string)
    • Example: "timeout", "syntax", "connection"
  3. search_error_by_category: Filter errors by category

    • Input: category (string)
    • Example: "Programming", "Database", "Network"
  4. get_error_categories: List all available categories

  5. get_error_summary: Get database statistics and overview

Integration with GitHub Copilot

This MCP server is designed to integrate with GitHub Copilot. The .vscode/mcp.json configuration file enables VS Code to use this server as a context provider.

To use with GitHub Copilot:

  1. Ensure the server is configured in .vscode/mcp.json
  2. The server will be available as a context source for Copilot
  3. Ask Copilot questions about error codes or problems, and it can query this server for solutions

Example Queries

  • "What is error code E001?"
  • "How do I fix a syntax error?"
  • "Show me all database errors"
  • "What are the available error categories?"
  • "Give me a summary of the error database"

Customizing the Error Database

To add or modify errors:

  1. Edit the create_error_db.py file
  2. Add new error entries to the error_data list
  3. Run the script to regenerate the Excel file:
    python create_error_db.py
    

Error Database Schema

Each error record contains:

  • error_code: Unique identifier (e.g., "E001")
  • error_type: Type of error (e.g., "Syntax Error")
  • error_description: Brief description of the error
  • severity: Error severity (Critical, High, Medium, Low)
  • category: Error category (Programming, Database, etc.)
  • solution: Detailed solution steps
  • example: Code examples or additional help
  • related_errors: Comma-separated list of related error codes

Development

The server is built using:

  • MCP SDK: For Model Context Protocol implementation
  • pandas: For Excel data processing
  • openpyxl: For Excel file handling
  • pydantic: For data validation

License

MIT License - see LICENSE file for details.

Support

For issues or questions about this MCP server, please refer to the MCP documentation: https://github.com/modelcontextprotocol/create-python-server

Metadata

Release files for error-repository-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for error-repository-server 0.1.0
File Size Uploaded Provenance Actions
error_repository_server-0.1.0.tar.gz 20.0 kB Without provenance Details for error_repository_server-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for error-repository-server 0.1.0
File Interpreter ABI Platform Actions
error_repository_server-0.1.0-py3-none-any.whl Python 3 none any Details for error_repository_server-0.1.0-py3-none-any.whl

Total release size: 28.0 kB

Release files / error_repository_server-0.1.0.tar.gz

Download URL error_repository_server-0.1.0.tar.gz
Size 20.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d056d6d1633c58f08936d93ecffa801cb77401168e2da787ef9544994fb3108e
BLAKE2b-256 checksum
How to use checksums
7bdaa0d1635454492fce61a2f8b0c997c2afb5dd954e7d985a7a3e4bebdcde8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / error_repository_server-0.1.0-py3-none-any.whl

Download URL error_repository_server-0.1.0-py3-none-any.whl
Size 7.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
60d8d4ae65f01c01061a41dba49041a991e05cbff4838d0d5f62bd3aacb353ce
BLAKE2b-256 checksum
How to use checksums
7961190bf14ac019c3c3f6515cf9b7f567a1daf901412faae9d0b0480a602a15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Security for error-repository-server 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page