FileMCP
devcheyannagraham/FileMCP
A mcp server I can use with my different AI projects
Instalação
npx convez-ai devcheyannagraham/FileMCP1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
FileMCP
FileMCP is a small Model Context Protocol (MCP) file server for AI Agents.
The server exposes simple file operations under an AgentFiles folder.
What It Does
FileMCP exposes these MCP tools:
createFileTool: creates a new file underAgentFilesand refuses to silently overwrite an existing file.overwriteFileTool: writes or replaces a file underAgentFiles.createDirectoryTool: creates a directory underAgentFiles.readFileTool: reads a UTF-8 text file fromAgentFiles.listDirectoryTool: lists files and folders underAgentFiles.
The read and list tools include path traversal checks so requests cannot escape the AgentFiles directory.
Requirements
- Node.js 18+
- npm
Install FileMCP
From your root directory:
npm install --save https://github.com/devcheyannagraham/FileMCP.git
Use With An Agent
In your import the server and pass it into your agent config:
import { filemcp } from "filemcp/server.ts";
import { agent } from "<your-agent-sdk>";
const myAgent = agent({
mcpServer: filemcp,
});
File Operations
File operations are relative to an AgentFiles folder in the working directory.
Asking the agent to read file.txt actually reads AgentFiles/file.txt.
Same with writes.
Ensure there is a folder called 'Agent Directory' in the root directory for the agent to read.
The code is simple and you can change this locally if you want. :)
Project Files
server.ts: creates the MCP server, registers tools, and starts stdio transport.tools.ts: implements the filesystem tools.toolSchemas.ts: defines tool descriptions and Zod schemas.