Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions crates/rmcp/Cargo.toml
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@


[package]
name = "rmcp"
license = { workspace = true }
Expand All@@ -25,7 +23,6 @@ tracing = { version = "0.1" }
tokio-util = { version = "0.7" }
pin-project-lite = "0.2"
paste = { version = "1", optional = true }

# for auto generate schema
schemars = { version = "0.8", optional = true }

Expand DownExpand Up@@ -103,3 +100,8 @@ name = "test_notification"
required-features = ["server", "client"]
path = "tests/test_notification.rs"

[[test]]
name = "test_logging"
required-features = ["server", "client"]
path = "tests/test_logging.rs"

4 changes: 2 additions & 2 deletions crates/rmcp/src/model.rs
Original file line numberDiff line numberDiff line change
Expand Up@@ -610,8 +610,8 @@ pub type PromptListChangedNotification = NotificationNoParam<PromptListChangedNo
const_string!(ToolListChangedNotificationMethod = "notifications/tools/list_changed");
pub type ToolListChangedNotification = NotificationNoParam<ToolListChangedNotificationMethod>;
// 日志相关
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
#[serde(rename_all = "camelCase")]
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Copy)]
#[serde(rename_all = "lowercase")] //match spec

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to argue that the camelCase is the more correct one. But they are the same in this case.

pub enum LoggingLevel {
Debug,
Info,
Expand Down
329 changes: 329 additions & 0 deletions crates/rmcp/tests/test_logging.rs
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,329 @@
// cargo test --features "server client" --package rmcp test_logging
use std::{
future::Future,
sync::{Arc, Mutex},
};

use rmcp::{
ClientHandler, Error as McpError, Peer, RoleClient, RoleServer, ServerHandler, ServiceExt,
model::{
LoggingLevel, LoggingMessageNotificationParam, ServerCapabilities, ServerInfo,
SetLevelRequestParam,
},
service::RequestContext,
};
use tokio::sync::Notify;

pub struct LoggingClient {
receive_signal: Arc<Notify>,
received_messages: Arc<Mutex<Vec<LoggingMessageNotificationParam>>>,
peer: Option<Peer<RoleClient>>,
}

impl ClientHandler for LoggingClient {
async fn on_logging_message(&self, params: LoggingMessageNotificationParam) {
println!("Client: Received log message: {:?}", params);
let mut messages = self.received_messages.lock().unwrap();
messages.push(params);
self.receive_signal.notify_one();
}

fn set_peer(&mut self, peer: Peer<RoleClient>) {
self.peer.replace(peer);
}

fn get_peer(&self) -> Option<Peer<RoleClient>> {
self.peer.clone()
}
}

pub struct TestServer {}

impl TestServer {
fn new() -> Self {
Self {}
}
}

impl ServerHandler for TestServer {
fn get_info(&self) -> ServerInfo {
ServerInfo {
capabilities: ServerCapabilities::builder().enable_logging().build(),
..Default::default()
}
}

fn set_level(
&self,
request: SetLevelRequestParam,
context: RequestContext<RoleServer>,
) -> impl Future<Output = Result<(), McpError>> + Send + '_ {
let peer = context.peer;
async move {
let (data, logger) = match request.level {
LoggingLevel::Error => (
serde_json::json!({
"message": "Failed to process request",
"error_code": "E1001",
"error_details": "Connection timeout",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("error_handler".to_string()),
),
LoggingLevel::Debug => (
serde_json::json!({
"message": "Processing request",
"function": "handle_request",
"line": 42,
"context": {
"request_id": "req-123",
"user_id": "user-456"
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("debug_logger".to_string()),
),
LoggingLevel::Info => (
serde_json::json!({
"message": "System status update",
"status": "healthy",
"metrics": {
"requests_per_second": 150,
"average_latency_ms": 45,
"error_rate": 0.01
},
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
Some("monitoring".to_string()),
),
_ => (
serde_json::json!({
"message": format!("Message at level {:?}", request.level),
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
None,
),
};

if let Err(e) = peer
.notify_logging_message(LoggingMessageNotificationParam {
level: request.level,
data,
logger,
})
.await
{
panic!("Failed to send notification: {}", e);
}
Ok(())
}
}
}

#[tokio::test]
async fn test_logging_spec_compliance() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;

// Test server can send messages before level is set
server
.peer()
.notify_logging_message(LoggingMessageNotificationParam {
level: LoggingLevel::Info,
data: serde_json::json!({
"message": "Server initiated message",
"timestamp": chrono::Utc::now().to_rfc3339(),
}),
logger: Some("test_server".to_string()),
})
.await?;

server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Verify server-initiated message
receive_signal.notified().await;
{
let mut messages = received_messages.lock().unwrap();
assert_eq!(messages.len(), 1, "Should receive server-initiated message");
messages.clear();
}

// Test level filtering and message format
for level in [
LoggingLevel::Emergency,
LoggingLevel::Warning,
LoggingLevel::Debug,
] {
client
.peer()
.set_level(SetLevelRequestParam { level })
.await?;
receive_signal.notified().await;

let mut messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();

// Verify required fields
assert_eq!(msg.level, level);
assert!(msg.data.is_object());

// Verify data format
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("message"));
assert!(data.contains_key("timestamp"));

// Verify timestamp
let timestamp = data["timestamp"].as_str().unwrap();
chrono::DateTime::parse_from_rfc3339(timestamp).expect("RFC3339 timestamp");

messages.clear();
}

client.cancel().await?;
Ok(())
}

#[tokio::test]
async fn test_logging_user_scenarios() -> anyhow::Result<()> {
let (server_transport, client_transport) = tokio::io::duplex(4096);
let receive_signal = Arc::new(Notify::new());
let received_messages = Arc::new(Mutex::new(Vec::new()));

// Start server
tokio::spawn(async move {
let server = TestServer::new().serve(server_transport).await?;
server.waiting().await?;
anyhow::Ok(())
});

let client = LoggingClient {
receive_signal: receive_signal.clone(),
received_messages: received_messages.clone(),
peer: None,
}
.serve(client_transport)
.await?;

// Test 1: Error reporting scenario
// User should see detailed error information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Error,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = &messages[0];
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("error_code"),
"Error should have an error code"
);
assert!(
data.contains_key("error_details"),
"Error should have details"
);
assert!(
data.contains_key("timestamp"),
"Should know when error occurred"
);
}

// Test 2: Debug scenario
// User debugging their application should see detailed information
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Debug,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(
data.contains_key("function"),
"Debug should show function name"
);
assert!(data.contains_key("line"), "Debug should show line number");
assert!(
data.contains_key("context"),
"Debug should show execution context"
);
}

// Test 3: Production monitoring scenario
// User monitoring production should see important status updates
client
.peer()
.set_level(SetLevelRequestParam {
level: LoggingLevel::Info,
})
.await?;
receive_signal.notified().await;
{
let messages = received_messages.lock().unwrap();
let msg = messages.last().unwrap();
let data = msg.data.as_object().unwrap();
assert!(data.contains_key("status"), "Should show system status");
assert!(data.contains_key("metrics"), "Should include metrics");
}

client.cancel().await?;
Ok(())
}

#[test]
fn test_logging_level_serialization() {
// Test all levels match spec exactly
let test_cases = [
(LoggingLevel::Alert, "alert"),
(LoggingLevel::Critical, "critical"),
(LoggingLevel::Debug, "debug"),
(LoggingLevel::Emergency, "emergency"),
(LoggingLevel::Error, "error"),
(LoggingLevel::Info, "info"),
(LoggingLevel::Notice, "notice"),
(LoggingLevel::Warning, "warning"),
];

for (level, expected) in test_cases {
let serialized = serde_json::to_string(&level).unwrap();
// Remove quotes from serialized string
let serialized = serialized.trim_matches('"');
assert_eq!(
serialized, expected,
"LoggingLevel::{:?} should serialize to \"{}\"",
level, expected
);
}

// Test deserialization from spec strings
for (level, spec_string) in test_cases {
let deserialized: LoggingLevel =
serde_json::from_str(&format!("\"{}\"", spec_string)).unwrap();
assert_eq!(
deserialized, level,
"\"{}\" should deserialize to LoggingLevel::{:?}",
spec_string, level
);
}
}