Description
# MCP Analyst Toolkit
A Model Context Protocol (MCP) server that provides tools for data analysts and researchers. This server offers access to databases, change logs, and external APIs through the MCP interface.
## Features
### Database Integration
- **ClickHouse Support**: Execute queries against ClickHouse databases
- **Database Discovery**: List available databases and table schemas
- **Query Templates**: Pre-built query templates for common tasks
### Data Resources
- **Change Log Management**: Access organizational change logs by time periods
- **Historical Data**: Track events and impacts across different quarters
- **Structured Data Access**: JSON-based change log data
### Developer Tools
- **GitHub Integration**: Integration with GitHub repositories and APIs
- **Extensible Architecture**: Support for adding new tools and resources
- **Type-Safe**: Built with Python type hints
## Installation
### Prerequisites
- Python 3.11 or higher
- [uv](https://docs.astral.sh/uv/) package manager (recommended)
### Setup
1. **Clone the repository:**
```bash
git clone <repository-url>
cd mcp-analyst-toolkit
```
2. **Install dependencies:**
```bash
uv pip install -e .
```
3. **Run the MCP server:**
```bash
uv run mcp dev src/mcp_server/server.py
```
The server will start and display:
- MCP Inspector URL for interactive testing
- Session token for authentication
- Server status and configuration
## Usage
### Running the Server
Start the MCP server in development mode:
```bash
uv run mcp dev src/mcp_server/server.py
```
Access the MCP Inspector at `http://localhost:6274/` to explore available tools and resources.
### Integration with Claude Code
Example of config to start using these tools in Claude Code.
```
{
"mcpServers": {
"analyst_toolkit": {
"command": "uv",
"args": [
"--directory",
"/path/to/repo/mcp-analyst-toolkit/src/mcp_server",
"run",
"server.py"
],
"env":