MCP Server Integration

AgentFS can run as an MCP (Model Context Protocol) server, exposing filesystem and key-value operations to AI assistants like Claude Desktop.

Starting the MCP Server

agentfs serve mcp my-agent

This starts an MCP server that exposes AgentFS tools over stdio.

Available Tools

Filesystem Tools

Tool	Description
`read_file`	Read file contents
`write_file`	Write file contents
`readdir`	List directory contents
`mkdir`	Create directory
`remove`	Remove file or directory
`rename`	Rename file or directory
`stat`	Get file metadata
`access`	Check file access permissions

Key-Value Tools

Tool	Description
`kv_get`	Get value by key
`kv_set`	Set key-value pair
`kv_delete`	Delete key
`kv_list`	List all keys

Limiting Exposed Tools

For security, you can limit which tools are available:

# Read-only mode
agentfs serve mcp my-agent --tools read_file,readdir,stat,kv_get,kv_list

# Filesystem only
agentfs serve mcp my-agent --tools read_file,write_file,readdir,mkdir,remove

# Key-value only
agentfs serve mcp my-agent --tools kv_get,kv_set,kv_delete,kv_list

Security Considerations

The MCP server gives AI assistants direct access to the AgentFS filesystem. Consider these security practices:

Limit tools - Only expose tools the assistant needs
Use overlays - Create overlay filesystems instead of giving access to real directories
Review the agent database - Check .agentfs/*.db periodically

Debugging

Check if the MCP server is working:

# Run manually to see output
agentfs serve mcp my-agent

# Check if the database exists
ls -la .agentfs/my-agent.db

AgentFS

Guides

SDKs

Reference

MCP Server Integration

Starting the MCP Server

Available Tools

Filesystem Tools

Key-Value Tools

Limiting Exposed Tools

Security Considerations

Debugging

Next Steps

NFS Server

Copy-on-Write Overlays

​Starting the MCP Server

​Available Tools

​Filesystem Tools

​Key-Value Tools

​Limiting Exposed Tools

​Security Considerations

​Debugging

​Next Steps

NFS Server

Copy-on-Write Overlays

Starting the MCP Server

Available Tools

Filesystem Tools

Key-Value Tools

Limiting Exposed Tools

Security Considerations

Debugging

Next Steps