文件系统
使用 mcp-framework 构建的模型上下文协议 (MCP) 服务器。
快速入门
# Install dependencies
npm install
# Build the project
npm run build
项目结构
filesystem/
├── src/
│ ├── tools/ # MCP Tools
│ │ └── ExampleTool.ts
│ └── index.ts # Server entry point
├── package.json
└── tsconfig.json
添加组件
该项目附带一个示例工具,位于src/tools/ExampleTool.ts
。您可以使用 CLI 添加更多工具:
# Add a new tool
mcp add tool my-tool
# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler
工具开发
示例工具结构:
import { MCPTool } from "mcp-framework";
import { z } from "zod";
interface MyToolInput {
message: string;
}
class MyTool extends MCPTool<MyToolInput> {
name = "my_tool";
description = "Describes what your tool does";
schema = {
message: {
type: z.string(),
description: "Description of this input parameter",
},
};
async execute(input: MyToolInput) {
// Your tool logic here
return `Processed: ${input.message}`;
}
}
export default MyTool;
发布到 npm
更新你的 package.json:
确保
name
唯一并遵循 npm 命名约定设置适当的
version
添加
description
、author
、license
等。检查
bin
指向正确的入口文件
本地构建和测试:
npm run build npm link filesystem # Test your CLI locally登录 npm(如有必要,请创建帐户):
npm login发布你的包:
npm publish
发布后,用户可以将其添加到他们的 claude 桌面客户端(见下文)或使用 npx 运行它
## Using with Claude Desktop
### Local Development
Add this configuration to your Claude Desktop config file:
**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"filesystem": {
"command": "node",
"args":["/absolute/path/to/filesystem/dist/index.js"]
}
}
}
发布后
将此配置添加到您的 Claude Desktop 配置文件:
MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["filesystem"]
}
}
}
构建和测试
更改你的工具
运行
npm run build
进行编译服务器将在启动时自动加载您的工具
了解更多
This server cannot be installed
模型上下文协议服务器通过向 Claude 或其他 AI 助手提供文件系统访问和管理功能来扩展 AI 功能。
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.Last updated -5
- AsecurityAlicenseAqualityA Model Context Protocol server that provides AI agents with secure access to local filesystem operations, enabling reading, writing, and managing files through a standardized interface.Last updated -105619Apache 2.0
- -securityAlicense-qualityA simple Model Context Protocol server that enables AI assistants to interact with local file systems, allowing them to read, write, update, and delete files within a specified project directory.Last updated -MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to manage song requests, monitor queues, and interact with streaming platforms' song request systems.Last updated -1121MIT License