spreadsheet-mcp 0.10.1

Stateful MCP server for spreadsheet analysis and editing — token-efficient tools for LLM agents to read, profile, edit, and recalculate .xlsx workbooks
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

use crate::model::{WorkbookId, WorkbookListResponse};
use crate::tools::filters::WorkbookFilter;
use crate::workbook::WorkbookContext;
use anyhow::Result;

pub mod path_workspace;
pub mod virtual_workspace;

pub use path_workspace::PathWorkspaceRepository;
pub use virtual_workspace::{VirtualWorkbookInput, VirtualWorkspaceRepository};

#[derive(Debug, Clone)]
pub enum WorkbookSource {
    Path(std::path::PathBuf),
    Virtual(String),
}

#[derive(Debug, Clone)]
pub struct ResolvedWorkbookRef {
    pub workbook_id: WorkbookId,
    pub short_id: String,
    pub revision_id: Option<String>,
    pub source: WorkbookSource,
}

pub trait WorkbookRepository: Send + Sync {
    fn list(&self, filter: &WorkbookFilter) -> Result<WorkbookListResponse>;
    fn resolve(&self, id_or_alias: &WorkbookId) -> Result<ResolvedWorkbookRef>;
    fn load_context(&self, resolved: &ResolvedWorkbookRef) -> Result<WorkbookContext>;
}