mcp-execution-server 0.7.0

MCP server for progressive loading TypeScript code generation
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
68

//! MCP server library for progressive loading generation.
//!
//! This crate provides an MCP server that helps generate progressive loading
//! TypeScript files for other MCP servers. It leverages Claude's natural
//! language understanding for tool categorization - no separate LLM API needed.
//!
//! # Architecture
//!
//! The server implements three main tools:
//!
//! 1. **`introspect_server`** - Connect to a target MCP server and discover its tools
//! 2. **`save_categorized_tools`** - Generate TypeScript files with Claude's categorization
//! 3. **`list_generated_servers`** - List all servers with generated files
//!
//! # Workflow
//!
//! 1. User asks Claude to generate progressive loading for an MCP server
//! 2. Claude calls `introspect_server` to discover tools
//! 3. Claude analyzes tool metadata and assigns categories, keywords, descriptions
//! 4. Claude calls `save_categorized_tools` with categorization
//! 5. Server generates TypeScript files with discovery headers
//!
//! # Examples
//!
//! ```no_run
//! use mcp_execution_server::service::GeneratorService;
//! use rmcp::transport::stdio;
//! use rmcp::ServiceExt;
//!
//! # async fn example() -> anyhow::Result<()> {
//! // Create and run the service
//! let service = GeneratorService::new().serve(stdio()).await?;
//! service.waiting().await?;
//! # Ok(())
//! # }
//! ```
//!
//! # State Management
//!
//! The server maintains temporary session state between `introspect_server` and
//! `save_categorized_tools` calls. Sessions expire after 30 minutes and are
//! cleaned up lazily.
//!
//! # Key Benefits
//!
//! - **No LLM API**: Claude (the conversation LLM) does categorization
//! - **Human-in-the-loop**: User can review and adjust categories
//! - **Progressive loading**: 98% token savings (30,000 → 500-1,500 tokens)
//! - **Type-safe**: Full TypeScript types from MCP schemas
//! - **Discoverable**: grep-friendly headers for tool discovery

pub mod service;
pub mod state;
pub mod types;

pub use service::GeneratorService;
pub use state::StateManager;
pub use types::{
    CategorizedTool, GeneratedServerInfo, IntrospectServerParams, IntrospectServerResult,
    ListGeneratedServersParams, ListGeneratedServersResult, PendingGeneration,
    SaveCategorizedToolsParams, SaveCategorizedToolsResult, ToolGenerationError, ToolMetadata,
};

// Re-export skill types from mcp-skill crate
pub use mcp_execution_skill::{
    GenerateSkillParams, GenerateSkillResult, SaveSkillParams, SaveSkillResult, SkillCategory,
    SkillMetadata, SkillTool, ToolExample,
};