mcp-kit 0.4.0

# mcp-kit v0.2.0 - Complete Plugin System Release

## Release Summary

**Version:** 0.1.6 → 0.2.0  
**Release Date:** March 15, 2026  
**Major Feature:** Plugin System with Real API Integrations

---

## What's New

### 🧩 Plugin System
- Dynamic loading of tools, resources, and prompts
- Native plugin support (.so, .dylib, .dll)
- Plugin configuration and lifecycle management
- Priority-based loading
- Permission system

### 📦 5 Production-Ready Plugins

All plugins include **REAL API/database integration**:

| Plugin | Tools | API Type | Setup Time |
|--------|-------|----------|------------|
| Weather | 2 | Mock | 0 min (works immediately) |
| GitHub | 4 | REST API v3 | 5 min (need token) |
| Jira | 4 | REST API v3 | 5 min (need token) |
| Confluence | 4 | REST API | 5 min (need token) |
| ClickHouse | 6 | HTTP Interface | 2 min (Docker) |
| **Total** | **20** | **4 Real + 1 Mock** | |

---

## Installation

```toml
[dependencies]
mcp-kit = "0.2"
```

For plugin development:
```toml
[dependencies]
mcp-kit = { version = "0.2", features = ["plugin", "plugin-native"] }
```

---

## Quick Start Examples

### GitHub Plugin
```bash
export GITHUB_TOKEN=ghp_your_token
cargo run --example plugin_github --features plugin,plugin-native
```

### Jira Plugin
```bash
export JIRA_BASE_URL="https://domain.atlassian.net"
export JIRA_EMAIL="you@example.com"
export JIRA_API_TOKEN="your-token"
export JIRA_PROJECT_KEY="PROJ"
cargo run --example plugin_jira --features plugin,plugin-native
```

### Confluence Plugin
```bash
export CONFLUENCE_BASE_URL="https://domain.atlassian.net"
export CONFLUENCE_EMAIL="you@example.com"
export CONFLUENCE_API_TOKEN="your-token"
export CONFLUENCE_SPACE_KEY="TEAM"
cargo run --example plugin_confluence --features plugin,plugin-native
```

### ClickHouse Plugin
```bash
docker run -d -p 8123:8123 clickhouse/clickhouse-server
export CLICKHOUSE_URL="http://localhost:8123"
cargo run --example plugin_clickhouse --features plugin,plugin-native
```

---

## Plugin Capabilities

### GitHub (4 tools)
- `github_get_repo` - Repository information
- `github_list_repos` - List repositories
- `github_create_issue` - Create issues
- `github_list_prs` - List pull requests

### Jira (4 tools)
- `jira_create_issue` - Create issues
- `jira_get_issue` - Get issue details
- `jira_search` - Search with JQL
- `jira_add_comment` - Add comments

### Confluence (4 tools)
- `confluence_create_page` - Create pages
- `confluence_get_page` - Get page content
- `confluence_search` - Search with CQL
- `confluence_list_pages` - List pages

### ClickHouse (6 tools)
- `clickhouse_query` - Execute SQL queries
- `clickhouse_table_info` - Table schema and stats
- `clickhouse_analytics` - Generate reports
- `clickhouse_list_tables` - List tables
- `clickhouse_stats` - Database statistics
- `clickhouse_insert` - Insert data

---

## New Features

### Plugin Definition
```rust
impl McpPlugin for MyPlugin {
    fn name(&self) -> &str { "my-plugin" }
    fn version(&self) -> &str { "1.0.0" }
    
    fn register_tools(&self) -> Vec<ToolDefinition> {
        vec![/* tools */]
    }
    
    fn on_load(&mut self, config: &PluginConfig) -> McpResult<()> {
        // Initialize from config
        Ok(())
    }
}
```

### Plugin Loading
```rust
let mut manager = PluginManager::new();
manager.register_plugin(MyPlugin::new(), config)?;

McpServer::builder()
    .with_plugin_manager(manager)
    .build()
```

---

## Documentation

- [Plugin System Guide](docs/PLUGINS.md) - Complete guide
- [Plugin Examples](examples/PLUGINS.md) - Setup instructions
- [GitHub Plugin Guide](examples/GITHUB_PLUGIN.md) - GitHub integration
- [ClickHouse Plugin Guide](examples/CLICKHOUSE_PLUGIN.md) - Database integration
- [CHANGELOG](CHANGELOG.md) - Detailed changes

---

## Build Status

✅ All examples build successfully  
✅ All tests pass  
✅ Code formatted  
✅ Documentation complete  

```bash
cargo build --all-features
cargo test --workspace --all-features
cargo fmt --all --check
```

---

## Breaking Changes

**None** - This is a backward-compatible release. All existing code continues to work.

---

## Dependencies Added

```toml
# Plugin system
libloading = "0.8"        # Native plugin loading
wasmtime = "26"           # WASM support (optional)
wasmtime-wasi = "26"      # WASI support (optional)
notify = "7"              # Hot reload (optional)

# Real API examples (dev-dependencies)
reqwest = "0.12"          # HTTP client
base64 = "0.22"           # Basic Auth
urlencoding = "2.1"       # URL encoding
```

---

## Statistics

- **Code:** 2,711 lines (plugin system + examples)
- **Documentation:** 1,510 lines
- **Total:** 4,221 lines of new content
- **Plugins:** 5 working plugins
- **Tools:** 20 functional tools
- **API Integrations:** 4 (GitHub, Jira, Confluence, ClickHouse)

---

## Migration Guide

No migration needed! Just update version:

```toml
[dependencies]
mcp-kit = "0.2"  # Was: "0.1"
```

All existing code remains compatible.

---

## Contributors

This release was made possible by the MCP Kit Team.

---

## Links

- **Repository:** https://github.com/KSD-CO/mcp-kit
- **Documentation:** https://docs.rs/mcp-kit
- **Crates.io:** https://crates.io/crates/mcp-kit
- **MCP Specification:** https://modelcontextprotocol.io/

---

## Next Release (0.3.0 - Planned)

- WASM plugin loading implementation
- Hot reload functionality
- Plugin registry and marketplace
- More plugin examples (Slack, Discord, PostgreSQL)
- Enhanced error handling
- Query caching for database plugins

---

**Thank you for using mcp-kit!** 🎉

If you have questions or feedback, please open an issue on GitHub.