foundry-mcp 0.7.1

A comprehensive CLI tool and MCP server for deterministic project management and AI coding assistant integration
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
69
70
71
72
73

//! # MCP Server Implementation
//!
//! This module provides the MCP server startup and configuration functionality.
//! The server uses stdio transport for communication with MCP clients like Claude.

use anyhow::Result;
use rust_mcp_sdk::{
    McpServer,
    mcp_server::server_runtime::create_server,
    schema::{
        Implementation, InitializeResult, LATEST_PROTOCOL_VERSION, ServerCapabilities,
        ServerCapabilitiesResources, ServerCapabilitiesTools,
    },
};
use rust_mcp_transport::{StdioTransport, TransportOptions};

use crate::mcp::{error::FoundryMcpError, handlers::FoundryServerHandler};

/// MCP Server configuration and startup
pub struct FoundryMcpServer;

impl FoundryMcpServer {
    /// Start the MCP server with stdio transport
    ///
    /// This is the main entry point for MCP server mode, providing all 8 foundry
    /// commands as MCP tools with identical functionality to the CLI.
    pub async fn start() -> Result<(), FoundryMcpError> {
        tracing::info!("Starting Foundry MCP server");

        // Create server details following PRD specifications
        let server_details = InitializeResult {
            server_info: Implementation {
                name: "Foundry MCP Server".to_string(),
                version: env!("CARGO_PKG_VERSION").to_string(),
                title: Some("Foundry Project Management MCP Server".to_string()),
            },
            capabilities: ServerCapabilities {
                tools: Some(ServerCapabilitiesTools { list_changed: None }),
                resources: Some(ServerCapabilitiesResources {
                    subscribe: None,
                    list_changed: None,
                }),
                ..Default::default()
            },
            meta: None,
            instructions: Some(
                "Foundry MCP Server provides project management tools for LLM-driven development. \
                Use create_project to start new projects, load_project to resume work, \
                create_spec for feature planning, and get_foundry_help for guidance."
                    .to_string(),
            ),
            protocol_version: LATEST_PROTOCOL_VERSION.to_string(),
        };

        // Create the server handler
        let handler = FoundryServerHandler::new();

        // Create stdio transport
        let transport_options = TransportOptions::default();
        let transport = StdioTransport::new(transport_options).map_err(|e| {
            FoundryMcpError::transport_error(format!("Failed to create stdio transport: {}", e))
        })?;

        // Create and start the server
        tracing::info!("Foundry MCP server started, listening on stdio");
        let server = create_server(server_details, transport, handler);
        server.start().await.map_err(|e| {
            FoundryMcpError::internal_error(format!("MCP server runtime error: {}", e))
        })?;

        Ok(())
    }
}