Struct CodeSystemGraphServer 

pub struct CodeSystemGraphServer { /* private fields */ }

Workspace-scoped Code System Graph MCP server with an optional explicit admin profile.

Implementations

impl CodeSystemGraphServer

pub fn new(database_path: PathBuf, workspace: String) -> Self

Creates a read-only server for one configured workspace.

pub fn with_admin_profile(self, enabled: bool) -> Self

Enables or disables the explicit administrative MCP profile.

Disabled routes are absent from discovery and cannot be called. Applications should map their trusted CODE_SYSTEM_GRAPH_MCP_ADMIN=1-equivalent configuration to this constructor option; request arguments can never enable the profile.

pub fn with_codegraph(self, enabled: bool, binary: Option<OsString>) -> Self

Applies trusted process-level CodeGraph policy to exploration, impact, and scans.

pub fn with_pull_request_providers(self, github: bool, bitbucket: bool) -> Self

Enables selected public pull-request providers while retaining per-request consent.

pub fn trace_tool_attr() -> Tool

Generated tool metadata function for trace

pub fn trace( &self, Parameters: Parameters<TraceInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<TraceReport>>> + Send + '_>>

Traces a bounded path through the current federated snapshot.

pub fn query_tool_attr() -> Tool

Generated tool metadata function for query

pub fn query( &self, Parameters: Parameters<SearchInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<SearchReport>>> + Send + '_>>

Searches ranked federated entities without returning source bodies.

pub fn explore_tool_attr() -> Tool

Generated tool metadata function for explore

pub fn explore( &self, Parameters: Parameters<ExploreInput>, ) -> Pin<Box<dyn Future<Output = Result<Json<ToolEnvelope<LocalContextResult>>, McpError>> + Send + '_>>

Explores bounded repository-local source and flow context without persisting source.

pub fn communities_tool_attr() -> Tool

Generated tool metadata function for communities

pub fn communities( &self, Parameters: Parameters<CommunitiesInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<CommunityReport>>> + Send + '_>>

Lists, inspects, or compares persisted deterministic communities.

pub fn impact_tool_attr() -> Tool

Generated tool metadata function for impact

pub fn impact( &self, Parameters: Parameters<ImpactRequest>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<ImpactReport>>> + Send + '_>>

Computes conservative impact without executing tests or repository commands.

pub fn analyze_changes_tool_attr() -> Tool

Generated tool metadata function for analyze_changes

pub fn analyze_changes( &self, Parameters: Parameters<ChangesInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<ChangeImpactReport>>> + Send + '_>>

Inspects bounded local Git changes without modifying repository state.

pub fn analyze_pull_request_tool_attr() -> Tool

Generated tool metadata function for analyze_pull_request

pub fn analyze_pull_request( &self, Parameters: Parameters<PullRequestInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<PullRequestInspection>>> + Send + '_>>

Inspects one explicitly enabled public pull-request provider.

pub fn status_tool_attr() -> Tool

Generated tool metadata function for status

pub fn status( &self, Parameters: Parameters<WorkspaceInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<GraphStatusReport>>> + Send + '_>>

Reports persisted snapshot health without reading repository source files.

pub fn contracts_tool_attr() -> Tool

Generated tool metadata function for contracts

pub fn contracts( &self, Parameters: Parameters<ContractsInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<ContractReport>>> + Send + '_>>

Lists a bounded page of contract entities from the immutable graph snapshot.

pub fn source_context_tool_attr() -> Tool

Generated tool metadata function for source_context

pub fn source_context( &self, Parameters: Parameters<SourceContextInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<SourceContextReport>>> + Send + '_>>

Returns bounded persisted graph and evidence metadata for one entity.

pub fn scan_tool_attr() -> Tool

Generated tool metadata function for scan

pub fn scan( &self, Parameters: Parameters<WorkspaceInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<AdminAudit<ScanSummary>>>> + Send + '_>>

Scans and atomically publishes the configured workspace.

pub fn update_workspace_tool_attr() -> Tool

Generated tool metadata function for update_workspace

pub fn update_workspace( &self, Parameters: Parameters<WorkspaceUpdateInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<AdminAudit<ManifestAdminReport>>>> + Send + '_>>

Adds or removes one repository entry through the constrained manifest editor.

pub fn write_manual_link_tool_attr() -> Tool

Generated tool metadata function for write_manual_link

pub fn write_manual_link( &self, Parameters: Parameters<ManualLinkWriteInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<AdminAudit<ManifestAdminReport>>>> + Send + '_>>

Appends one exact manual relationship declaration and republishes the workspace.

pub fn clean_cache_tool_attr() -> Tool

Generated tool metadata function for clean_cache

pub fn clean_cache( &self, Parameters: Parameters<CacheCleanInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<AdminAudit<CacheCleanReport>>>> + Send + '_>>

Removes bounded reusable query results for the configured workspace.

pub fn recompute_communities_tool_attr() -> Tool

Generated tool metadata function for recompute_communities

pub fn recompute_communities( &self, Parameters: Parameters<WorkspaceInput>, ) -> Pin<Box<dyn Future<Output = Json<ToolEnvelope<AdminAudit<ScanSummary>>>> + Send + '_>>

Recomputes communities by publishing a freshly analyzed workspace snapshot.

Trait Implementations

impl Clone for CodeSystemGraphServer

fn clone(&self) -> CodeSystemGraphServer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CodeSystemGraphServer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ServerHandler for CodeSystemGraphServer

fn get_info(&self) -> ServerInfo

async fn list_resources( &self, _request: Option<PaginatedRequestParams>, _context: RequestContext<RoleServer>, ) -> Result<ListResourcesResult, McpError>

async fn read_resource( &self, request: ReadResourceRequestParams, _context: RequestContext<RoleServer>, ) -> Result<ReadResourceResponse, McpError>

async fn call_tool( &self, request: CallToolRequestParams, context: RequestContext<RoleServer>, ) -> Result<CallToolResponse, ErrorData>

Handle a tools/call request from a client.

async fn list_tools( &self, _request: Option<PaginatedRequestParams>, _context: RequestContext<RoleServer>, ) -> Result<ListToolsResult, ErrorData>

fn get_tool(&self, name: &str) -> Option<Tool>

Get a tool definition by name.

fn ping( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn initialize( &self, request: InitializeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<InitializeResult, ErrorData>> + MaybeSendFuture

fn supported_protocol_versions(&self) -> Cow<'static, [ProtocolVersion]>

Return the protocol versions supported by this server.

fn discover( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<DiscoverResult, ErrorData>> + MaybeSendFuture

Return this server’s discovery information.

fn complete( &self, request: CompleteRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CompleteResult, ErrorData>> + MaybeSendFuture

fn set_level( &self, request: SetLevelRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn get_prompt( &self, request: GetPromptRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetPromptResponse, ErrorData>> + MaybeSendFuture

fn list_prompts( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListPromptsResult, ErrorData>> + MaybeSendFuture

fn list_resource_templates( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourceTemplatesResult, ErrorData>> + MaybeSendFuture

fn accepted_subscription_filter( &self, requested: &SubscriptionFilter, ) -> Option<SubscriptionFilter>

Return the subset of a requested notification filter this server accepts.

fn listen( &self, context: SubscriptionContext, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

Run one established subscription until it is cancelled or closed gracefully.

fn subscribe( &self, request: SubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

👎Deprecated:

resources/subscribe is legacy-only; implement accepted_subscription_filter and listen for protocol version 2026-07-28

fn unsubscribe( &self, request: UnsubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

👎Deprecated:

resources/unsubscribe is legacy-only; subscriptions/listen is cancelled through its request lifecycle

fn on_custom_request( &self, request: CustomRequest, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CustomResult, ErrorData>> + MaybeSendFuture

fn on_cancelled( &self, notification: CancelledNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_progress( &self, notification: ProgressNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_initialized( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_roots_list_changed( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_custom_notification( &self, notification: CustomNotification, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn get_task( &self, request: GetTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetTaskResult, ErrorData>> + MaybeSendFuture

SEP-2663 tasks/get: return the current DetailedTask state.

fn update_task( &self, request: UpdateTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

SEP-2663 tasks/update: accept responses to outstanding in-task input requests. Returns an empty acknowledgement on success.

fn cancel_task( &self, request: CancelTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

SEP-2663 tasks/cancel: cooperative cancellation. Returns an empty acknowledgement; the task’s observable status may lag.