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
From PyPI (Recommended)
pip install error-repository-server
From Source
- Clone this repository:
git clone https://github.com/yourusername/error-repository-server.git cd error-repository-server
- 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:
-
search_error_by_code: Find a specific error by its code
- Input:
error_code(string) - Example: "E001", "DB001", "NET001"
- Input:
-
search_error_by_description: Search errors by keywords
- Input:
description(string) - Example: "timeout", "syntax", "connection"
- Input:
-
search_error_by_category: Filter errors by category
- Input:
category(string) - Example: "Programming", "Database", "Network"
- Input:
-
get_error_categories: List all available categories
-
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:
- Ensure the server is configured in
.vscode/mcp.json - The server will be available as a context source for Copilot
- 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:
- Edit the
create_error_db.pyfile - Add new error entries to the
error_datalist - 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 errorseverity: Error severity (Critical, High, Medium, Low)category: Error category (Programming, Database, etc.)solution: Detailed solution stepsexample: Code examples or additional helprelated_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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.