68 lines
1.4 KiB
Markdown
68 lines
1.4 KiB
Markdown
# MCP Common
|
|
|
|
**[English](README.md)** | **[简体中文](README_zh-CN.md)**
|
|
|
|
---
|
|
|
|
# MCP Common
|
|
|
|
MCP 代理组件的共享类型和工具。
|
|
|
|
## 概述
|
|
|
|
`mcp-common` 为 `mcp-sse-proxy` 和 `mcp-streamable-proxy` 提供共享功能，避免代码重复。
|
|
|
|
## 功能特性
|
|
|
|
- **配置类型**: `McpServiceConfig`、`McpClientConfig` 用于统一配置管理
|
|
- **工具过滤**: `ToolFilter` 用于按名称或模式过滤 MCP 工具
|
|
- **OpenTelemetry 支持**: 可选的遥测功能用于分布式追踪
|
|
|
|
## 功能标志
|
|
|
|
- `telemetry`: 基础 OpenTelemetry 支持
|
|
- `otlp`: OTLP 导出器支持（用于 Jaeger 等）
|
|
|
|
## 安装
|
|
|
|
添加到 `Cargo.toml`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
mcp-common = { version = "0.1.5", path = "../mcp-common" }
|
|
```
|
|
|
|
## 使用
|
|
|
|
```rust
|
|
use mcp_common::{McpServiceConfig, McpClientConfig, ToolFilter};
|
|
|
|
// 创建客户端配置
|
|
let client_config = McpClientConfig::new("http://localhost:8080/mcp")
|
|
.with_headers(vec![("Authorization".to_string(), "Bearer token".to_string())]);
|
|
|
|
// 创建服务配置
|
|
let service_config = McpServiceConfig::new("my-service".to_string())
|
|
.with_persistent_type();
|
|
|
|
// 使用工具过滤器
|
|
let filter = ToolFilter::new(vec!["tool1".to_string(), "tool2".to_string()]);
|
|
```
|
|
|
|
## 开发
|
|
|
|
```bash
|
|
# 构建
|
|
cargo build -p mcp-common
|
|
|
|
# 测试
|
|
cargo test -p mcp-common
|
|
|
|
# 启用功能
|
|
cargo build -p mcp-common --features telemetry,otlp
|
|
```
|
|
|
|
## 许可证
|
|
|
|
MIT OR Apache-2.0
|