I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

BSMI021_MCP-Filesystem-Server
镜像://github.com/bsmi021/mcp-filesystem-server
0
Github Watches
1
Github Forks
0
Github Stars
Filesystem MCP Server
A Model Context Protocol (MCP) server implementation providing file system operations, analysis, and manipulation capabilities through a standardized tool interface.
Architecture
The server is built on the MCP SDK and organized into distinct layers:
graph TD
A[MCP Server Layer] --> B[Tool Registry]
B --> C[Operations Layer]
C --> D[File System Operations]
C --> E[Analysis Operations]
C --> F[Stream Operations]
Components
- Server Layer: Handles MCP protocol communication and tool dispatch
- Tool Registry: Manages tool registration and execution
- Operations Layer: Implements core functionality
- File System Interface: Provides safe file system access
Installation
- Clone the repository:
git clone <repository-url>
cd filesystem-server
- Install dependencies:
npm install
- Build the server:
npm run build
- Configure MCP settings (cline_mcp_settings.json):
{
"mcpServers": {
"filesystem": {
"command": "node",
"args": ["path/to/filesystem-server/build/index.js"]
}
}
}
Tool Reference
Directory Operations
list_directory
Lists directory contents with metadata.
interface ListDirectoryParams {
path: string; // Directory path
recursive?: boolean; // List recursively (default: false)
}
interface ListDirectoryResult {
entries: {
name: string;
path: string;
isDirectory: boolean;
size: number;
created: string;
modified: string;
accessed: string;
mode: string;
}[];
}
create_directory
Creates a new directory.
interface CreateDirectoryParams {
path: string; // Directory path
recursive?: boolean; // Create parent directories (default: true)
}
File Operations
read_file
Reads file content with encoding support.
interface ReadFileParams {
path: string; // File path
encoding?: string; // File encoding (default: 'utf8')
}
write_file
Writes content to a file.
interface WriteFileParams {
path: string; // File path
content: string; // Content to write
encoding?: string; // File encoding (default: 'utf8')
}
append_file
Appends content to a file.
interface AppendFileParams {
path: string; // File path
content: string; // Content to append
encoding?: string; // File encoding (default: 'utf8')
}
Analysis Operations
analyze_text
Analyzes text file properties.
interface AnalyzeTextParams {
path: string; // File path
}
interface AnalyzeTextResult {
lineCount: number;
wordCount: number;
charCount: number;
encoding: string;
mimeType: string;
}
calculate_hash
Calculates file hash using specified algorithm.
interface CalculateHashParams {
path: string; // File path
algorithm?: 'md5' | 'sha1' | 'sha256' | 'sha512'; // Hash algorithm
}
interface CalculateHashResult {
hash: string;
algorithm: string;
}
find_duplicates
Identifies duplicate files in a directory.
interface FindDuplicatesParams {
path: string; // Directory path
}
interface FindDuplicatesResult {
duplicates: {
hash: string;
size: number;
files: string[];
}[];
}
Compression Operations
create_zip
Creates a ZIP archive.
interface CreateZipParams {
files: string[]; // Files to include
output: string; // Output ZIP path
}
extract_zip
Extracts a ZIP archive.
interface ExtractZipParams {
path: string; // ZIP file path
output: string; // Output directory
}
Error Handling
The server uses standard MCP error codes:
enum ErrorCode {
ParseError = -32700,
InvalidRequest = -32600,
MethodNotFound = -32601,
InvalidParams = -32602,
InternalError = -32603
}
Error responses include:
- Error code
- Human-readable message
- Additional context when available
Example error:
{
"code": -32602,
"message": "File not found: /path/to/file.txt"
}
Development
Project Structure
src/
├── operations/ # Core operations implementation
├── tools/ # MCP tool definitions and handlers
├── __tests__/ # Test suites
├── index.ts # Entry point
├── server.ts # MCP server setup
├── types.ts # Type definitions
└── utils.ts # Utility functions
Running Tests
Run the test suite:
npm test
Run with coverage:
npm run test:coverage
Development Mode
Run in watch mode:
npm run watch
Code Quality
Lint the codebase:
npm run lint
Type check:
npm run type-check
Dependencies
Core dependencies:
- @modelcontextprotocol/sdk: MCP server implementation
- file-type: File type detection
- mime-types: MIME type lookup
- crypto-js: File hashing
- archiver: ZIP creation
- extract-zip: ZIP extraction
- iconv-lite: Text encoding
- chardet: Encoding detection
Development dependencies:
- typescript: Type system
- jest: Testing
- eslint: Linting
- prettier: Formatting
- ts-node: TypeScript execution
- nodemon: Development server
Contributing
- Fork the repository
- Create your feature branch
- Write tests for new features
- Ensure all tests pass
- Submit a pull request
License
MIT
相关推荐
Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.
This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.
Confidential guide on numerology and astrology, based of GG33 Public information
Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.
Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.
Reviews

user_EDuvtvoD
I recently integrated the mcp-netmiko-server into my network setup, and I couldn't be more pleased. This tool by upa streamlines server management with seamless automation capabilities. The intuitive design and stable performance have drastically improved my workflow. I highly recommend checking out the details here: https://mcp.so/server/mcp-netmiko-server/upa. Outstanding job upa!