MCP Tool Kit
March 27, 2025 ยท View on GitHub
A comprehensive toolkit for the Model Context Protocol (MCP) that provides integrations with various database systems and development tools.
Features
- SQL Server Integration: Seamless interaction with Microsoft SQL Server databases
- Execute custom SQL queries
- Retrieve table and schema information
- Explore database structure
- Jira Integration: Powerful issue tracking capabilities
- Extensible Architecture: Easily add new tools and integrations
- Multiple Operation Modes: Run in stdio or SSE server mode
Prerequisites
- Go 1.18 or higher
- Docker (for running SQL Server locally)
- SQL Server instance (local or remote)
- Environment variables configured for database access
Setup
Environment Configuration
Create a .env file in the project root with the following configuration:
# SQL Server Configuration
SQL_SERVER=your-server-address
SQL_PORT=1433
SQL_USER=sa
SQL_PASSWORD=YourStrongPassword!
SQL_DATABASE=your-database-name
# Optional: complete connection string (will be used if provided)
SQL_CONNECTION_STRING=Server=your-server-address;Database=your-database-name;User Id=sa;Password=YourStrongPassword!;MultipleActiveResultSets=True;TrustServerCertificate=True
# Jira Configuration
JIRA_API_KEY=your-jira-api-key
JIRA_URL=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@domain.com
# MCP Tools Configuration
CONFIG_TOOLS=sql-server,jira
# MCP Mode Configuration
MCP_MODE=stdio # Options: stdio, sse
Operation Modes
STDIO Mode (Default)
Standard I/O mode is the default operation mode. In this mode, the tool communicates through standard input and output streams, making it ideal for command-line integration.
To run in STDIO mode: Claude, cursor
{
"mcpServers": {
"script": {
"command": "/path/to/your/mcp-script",
"args": ["-env", "path-to-env-file"]
}
}
}
SSE Mode
Server-Sent Events (SSE) mode provides a web-based interface for the toolkit. It starts a web server that allows communication through HTTP requests and SSE for real-time updates.
To run in SSE mode:
MCP_MODE=sse go run main.go
This starts an SSE server on http://localhost:8080 with the following endpoints:
/message- For sending messages to the server/sse- For receiving SSE events from the server
Available Tools
SQL Server Tools
The MCP Tool Kit provides the following SQL Server tools:
sql_execute_query
Executes a SQL query and returns the results in a formatted table.
sql_get_tables
Returns a list of all tables in the database.
sql_get_table_schema
Returns the schema of a specific table.
sql_get_schemas
Returns a list of all schemas in the database.
Jira Tools
The MCP Tool Kit provides the following Jira tools:
jira_get_issue
Retrieves detailed information about a specific Jira issue, including status, assignee, description, subtasks, and available transitions.
jira_search_issue
Searches for Jira issues using JQL (Jira Query Language) and returns details such as summary, status, assignee, and priority.
jira_list_sprints
Lists all active and future sprints for a given Jira board.
jira_create_issue
Creates a new Jira issue and returns the created issue's key, ID, and URL.
jira_update_issue
Updates an existing Jira issue with new details. Only provided fields will be updated.
jira_list_statuses
Retrieves all available issue statuses for a specific Jira project.
jira_transition_issue
Transitions an issue through its workflow using a valid transition ID.