64BNo CVEsactive8 tools
Quick Install
{
"mcpServers": {
"file-system": {
"args": [
"-jar",
"/absolute/path/to/file-mcp-server-1.0.0.jar"
],
"command": "java"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/file-mcp-server)
Should you use this server?
A Spring Boot MCP server that exposes local file system and shell tools to Claude (or any MCP-compatible client).
✓
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
License not specified.
✓
Is it maintained?
Last commit 3 days ago.
i
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
A
Context cost
8 tools. ~300 tokens (0.1% of 200K).
README
file-mcp-server
A Spring Boot MCP server that exposes local file system and shell tools to Claude (or any MCP-compatible client).
Tools exposed
| Tool | Description |
|---|---|
readFile | Read the full contents of a file |
writeFile | Write (or overwrite) a file |
appendFile | Append text to a file |
deleteFile | Delete a file |
listDirectory | List files and subdirectories |
fileInfo | Get metadata (size, dates, type) |
searchFiles | Recursively search by filename substring |
runCommand | Execute a shell command |
Requirements
- Java 17+
- Maven 3.8+
Build
mvn clean package -DskipTests
The fat jar is produced at target/file-mcp-server-1.0.0.jar.
Run tests
mvn test
Connect to Claude Desktop
Add the following to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"file-system": {
"command": "java",
"args": ["-jar", "/absolute/path/to/file-mcp-server-1.0.0.jar"]
}
}
}
Restart Claude Desktop. The tools will appear in the tools panel automatically.
Project structure
src/
main/
java/com/example/filemcp/
FileMcpServerApplication.java ← entry point
FileSystemTools.java ← all @Tool methods
McpConfig.java ← registers tools with MCP
resources/
application.properties ← STDIO transport config
test/
java/com/example/filemcp/
FileSystemToolsTest.java ← unit tests
Adding new tools
- Add a new
@Tool-annotated method toFileSystemTools(or create a new@Serviceclass). - If you create a new service class, add it to the
MethodToolCallbackProviderinMcpConfig. - Rebuild and restart.
Security note
The runCommand tool executes arbitrary shell commands. For anything beyond personal/local use, consider restricting it to an allowlist of safe commands or removing it entirely.
Test This Server
No automated test available for this server. Check the GitHub README for setup instructions.
Tools (8)
readFileRead the full contents of a file
writeFileWrite (or overwrite) a file
appendFileAppend text to a file
deleteFileDelete a file
listDirectoryList files and subdirectories
fileInfoGet metadata (size, dates, type)
searchFilesRecursively search by filename substring
runCommandExecute a shell command
Score Breakdown
Security
10/30No known vulnerabilities.
○
Known CVEs — No package registry to scan
✗
Tool safety — Found: code execution, filesystem writes
✓
Tool poisoning — No poisoning indicators detected
✓
Injection vectors — No injection vectors detected
✗
Tool stability — Tool definitions changed since last scan
○
Dependency health — No package to analyze
✗
License — No license specified
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is File Mcp Server safe to use?
- File Mcp Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
- How do I install File Mcp Server?
- File Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
- What can File Mcp Server do?
- File Mcp Server provides 8 tools: readFile, writeFile, appendFile, deleteFile, listDirectory and 3 more. See the full tools list on the server page for descriptions and parameters.
- What AI clients work with File Mcp Server?
- File Mcp Server is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.
- Is File Mcp Server actively maintained?
- File Mcp Server is actively maintained — last commit was 3 days ago.
Similar servers
View all →
Memory MCP Server
OfficialNo CVEs98A
Persistent memory using a knowledge graph
5 toolsstdio83.8k93.5k/wk1d ago
H
Hash-verified file editing MCP server with token efficiency hook. 11 tools for AI coding agents.
No CVEs95A
Hash-verified file editing MCP server with token efficiency hook. 11 tools for AI coding agents.
5 toolsremote398685.9k/wk11h ago
Context Mode
No CVEs95A
Privacy-first. MCP is the protocol for tool access. We're the virtualization layer for context.
6 toolsremote7.3k10.0k/wk22h ago
Browser Tools Mcp
No CVEs94A
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
7 toolsremote7.2k2.9k/wk28d ago
MCP Security Weekly
Get CVE alerts and security updates for File Mcp Server and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.