{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6qy5xyuq6puu","handle":"mcp-filesystem","url":"https://wellknown.network/agents/mcp-filesystem","links":{"self":"https://wellknown.network/agents/mcp-filesystem/record.json","html":"https://wellknown.network/agents/mcp-filesystem","markdown":"https://wellknown.network/agents/mcp-filesystem/record.md","api":"https://wellknown.network/api/v1/agents/mcp-filesystem","status":"https://wellknown.network/api/v1/agents/mcp-filesystem/status","claim":"https://wellknown.network/agents/mcp-filesystem/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-filesystem/claim.json","badge":"https://wellknown.network/agents/mcp-filesystem/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-filesystem/history","tools":"https://wellknown.network/api/v1/agents/mcp-filesystem/tools"},"ard":{"identifier":"urn:air::server:mcp-filesystem","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-filesystem","summary":"A configurable MCP Server for Filesystem operations in Windows/Linux/MacOS, supporting stdio, streamable-http and SSE transports.","description":"# mcp_filesystem\n\n一个可配置的MCP服务器，用于文件系统操作，支持stdio、streamable-http和SSE传输协议。\n\n## 功能特性\n\n- 完整的文件系统操作（创建、读取、更新、删除文件和目录）\n- 跨平台支持（Windows、Linux、macOS）\n- 可配置的传输协议（stdio、streamable-http、SSE）\n- 无第三方依赖（仅使用Python标准库）\n- 深度适配uv工具，简化安装和使用\n\n## 快速开始\n\n### 安装uv\n\n```bash\n# Linux/macOS\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Windows\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n### 安装mcp-filesystem\n\n```bash\n# 使用uv直接从PyPI安装\nuv tool install mcp-filesystem\n\n# 或者从源码安装\ngit clone https://github.com/yangjiacheng1996/mcp_filesystem.git\ncd mcp_filesystem\nuv sync\n```\n\n### 使用方法\n\n#### 使用stdio传输协议（由MCP客户端自动管理）\nstdio传输协议不需要手动启动服务器。MCP客户端（如Cherry Studio）会在需要时自动启动和管理服务器进程。\n\n**配置方式（在MCP客户端中配置）：**\n- 类型: stdio\n- 命令: mcp-filesystem  \n- 参数: `--stdio`\n- 举例：安装Chatbox，创建自定义MCP，填入命令：D:/mcp_filesystem/.venv/Scripts/mcp-filesystem  --stdio\n\n**注意：** 以下命令仅用于测试和调试目的，会启动一个前台进程占用命令行：\n```bash\nmcp-filesystem --stdio\n```\n\n#### 使用streamable-http传输协议\n```bash\nmcp-filesystem --streamable-http --host 0.0.0.0 --port 8000\n```\n\n#### 使用SSE传输协议\n```bash\nmcp-filesystem --sse --host 0.0.0.0 --port 8000\n```\n\n### 命令行参数说明\n\n- `--config`: 配置文件路径（默认：自动查找config.toml）\n- `--stdio`: 使用stdio传输协议\n- `--streamable-http`: 使用streamable-http传输协议  \n- `--sse`: 使用SSE传输协议\n- `--host`: HTTP服务器主机地址（默认：从配置文件或0.0.0.0）\n- `--port`: HTTP服务器端口（默认：从配置文件或8000）\n\n## 传输协议\n\n### 1. **stdio**\n- 通过标准输入输出与MCP客户端通信\n- 适用于本地集成和命令行工具\n- 最简单的配置方式\n\n### 2. **streamable-http**\n- 通过HTTP流式传输协议通信\n- 服务器监听: http://127.0.0.1:8000/mcp\n- 适用于需要双向流式通信的场景\n\n### 3. **SSE** (Server-Sent Events)\n- 使用服务器发送事件协议\n- 服务器监听: http://127.0.0.1:8000/sse\n- 适用于需要实时事件推送的场景\n\n## 在Cherry Studio中配置\n\n### 对于stdio类型（推荐配置）:\n- 类型: stdio\n- 命令: mcp-filesystem\n- 参数: `--stdio`\n\n**注意：** 这是正确的配置方式，Cherry Studio会在需要时自动启动和管理服务器进程，无需手动运行命令。\n\n### 对于streamable-http类型:\n- 类型: streamable-http\n- URL: http://127.0.0.1:8000/mcp\n\n### 对于SSE类型:\n- 类型: sse\n- URL: http://127.0.0.1:8000/sse\n\n## 开发指南\n\n### 从源码开发\n\n```bash\n# 克隆项目\ngit clone https://github.com/yangjiacheng1996/mcp_filesystem.git\n…","publisher":{"name":"YANG Jiacheng","url":null},"homepage":"https://github.com/yangjiacheng1996/mcp_filesystem","repository":"https://github.com/yangjiacheng1996/mcp_filesystem","version":"0.3.0","license":"MIT","protocols":["mcp"],"tags":["mcp","filesystem","ai","llm","tool"],"pricing":null,"endpoints":[{"url":"pypi:mcp-filesystem","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-filesystem","registry":"pypi","observedAt":"2026-11-03T13:26:39.641Z","publishedAt":"2025-09-26T06:21:14.065558Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-filesystem","url":"https://pypi.org/project/mcp-filesystem/","firstSeenAt":"2026-09-10T01:20:48.560Z","fetchedAt":"2026-11-03T13:25:18.580Z","normalizedAt":"2026-11-03T13:25:18.580Z"}]},"firstSeenAt":"2026-09-10T01:20:48.560Z","updatedAt":"2026-11-03T13:26:39.641Z"}