FS

Exposes filesystem contents as MCP resources for LLM context integration.

go

36

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "riza-io-mcp-go": {
      "command": "/path/to/mcp-go-fs",
      "args": [
        "/path/to/root/directory"
      ]
    }
  }
}

The MCP (Model Context Protocol) server lets you expose context resources, prompts, and tools for your LLM workflows. By providing a standardized interface, you can connect clients to a local or remote MCP server and manage the context you supply to LLMs separately from the model itself.

How to use

You run a local MCP server that exposes resources and tools, then connect an MCP client to it. The example server shows how to expose a filesystem as resources, so your client can list and read files as part of the context provided to an LLM. You can wire this to any MCP client that supports the protocol, such as Claude Desktop, to start supplying contextual data to your LLM prompts.

How to install

Prerequisites: ensure you have a Go development environment installed and available on your system.

Create a local MCP server by saving the provided example code to a file labeled as a standalone Go program. You can adapt the filesystem exposure to your own root directory.
Build the server binary so you can run it from your shell.
Run the server, pointing it at the filesystem root you want to expose, for example a local directory you own.
Connect an MCP client to your running server using the configuration shown in the snippet below. The client will then be able to query and read resources from your exposed filesystem.

Configuration example

{
	"mcpServers": {
		"fs": {
			"command": "/path/to/mcp-go-fs",
			"args": [
				"/path/to/root/directory"
			]
		}
	}
}

Available tools

Initialize

Handle the initial MCP handshake, set protocol version, and declare the server’s capabilities to expose resources and prompts.

ListResources

Return a list of available resources with URIs, names, and MIME types so the client can browse what the server provides.

ReadResource

Fetch the contents of a requested resource and provide metadata such as its URI and MIME type.