mcp-common 0.1.13

Common types and utilities shared across MCP proxy components
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

# MCP Common

**[English](README.md)** | **[简体中文](README_zh-CN.md)**

---

# MCP Common

Shared types and utilities for MCP proxy components.

## Overview

`mcp-common` provides common functionality shared across `mcp-sse-proxy` and `mcp-streamable-proxy` to avoid code duplication.

## Features

- **Configuration Types**: `McpServiceConfig`, `McpClientConfig` for unified configuration management
- **Tool Filtering**: `ToolFilter` for filtering MCP tools by name or pattern
- **OpenTelemetry Support**: Optional telemetry features for distributed tracing

## Feature Flags

- `telemetry`: Basic OpenTelemetry support
- `otlp`: OTLP exporter support (for Jaeger, etc.)

## Installation

Add to `Cargo.toml`:

```toml
[dependencies]
mcp-common = { version = "0.1.5", path = "../mcp-common" }
```

## Usage

```rust
use mcp_common::{McpServiceConfig, McpClientConfig, ToolFilter};

// Create client configuration
let client_config = McpClientConfig::new("http://localhost:8080/mcp")
    .with_headers(vec![("Authorization".to_string(), "Bearer token".to_string())]);

// Create service configuration
let service_config = McpServiceConfig::new("my-service".to_string())
    .with_persistent_type();

// Use tool filter
let filter = ToolFilter::new(vec!["tool1".to_string(), "tool2".to_string()]);
```

## Development

```bash
# Build
cargo build -p mcp-common

# Test
cargo test -p mcp-common

# With features
cargo build -p mcp-common --features telemetry,otlp
```

## License

MIT OR Apache-2.0