AF

anhnv02/file-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

10 stars 8 forks 품질 61 트렌드 38Apache-2.0

FileMCP is a native macOS app that gives ChatGPT controlled access to a local workspace through MCP

개요

Your local workspace, connected to ChatGPT. On your terms. Get started · Features · Security · Development FileMCP is a native desktop application that gives ChatGPT controlled access to a local workspace through MCP. It can read and modify files, run Git operations, and—only when explicitly enabled—run local shell commands. The MCP server stays bound to 127.0.0.1. FileMCP uses OpenAI Secure MCP Tunnel to make that local server available to supported OpenAI products without opening a public inbound port on your computer. FileMCP can modify or delete files inside the directory you choose. If command execution is enabled, it can also run processes with the permissions of your signed-in OS user. Use a narrowly scoped workspace and enable shell access only when you trust the workflow using it. FileMCP is an independent open-source project. It is not an official OpenAI product. - Native desktop implementations: - on macOS. - on Windows.

README

원문 README의 일부입니다. 원문 보기.

Get started · Features · Security · Development

FileMCP is a native macOS and Windows desktop application that gives ChatGPT controlled access to a local workspace through MCP. It can read and modify files, run Git operations, and—only when explicitly enabled—run local shell commands.

The MCP server stays bound to 127.0.0.1. By default, FileMCP uses OpenAI Secure MCP Tunnel to connect supported OpenAI products without a public MCP endpoint. On macOS, you can alternatively use your own Cloudflare Tunnel with a public HTTPS hostname and OAuth. Both options establish an outbound tunnel rather than opening an inbound router port.

[!WARNING] FileMCP can modify or delete files inside the directory you choose. If command execution is enabled, it can also run processes with the permissions of your signed-in OS user. Use a narrowly scoped workspace and enable shell access only when you trust the workflow using it.

FileMCP is an independent open-source project. It is not an official OpenAI product.

Highlights

  • Native desktop implementations:
    • Swift + AppKit on macOS.
    • C# + .NET 8 + WPF on Windows.
  • Shared core tools on both platforms: filesystem access, Git, Codex-history import, MCP protocol support, OpenAI tunnel integration and optional command execution. Provider choices and permission controls differ; see Application settings.
  • Compact macOS interface with a workspace overview, persistent connection controls and a saved light/dark appearance choice.
  • Local MCP server listens on loopback only (127.0.0.1).
  • Built-in filesystem tools are restricted to one configured workspace root; optional shell commands are not OS-sandboxed.
  • Symlink/reparse-point and canonical-path checks protect the workspace boundary.
  • Git operations are available without enabling arbitrary shell execution.
  • Optional shell execution is off by default.
  • Runtime API keys are stored in the operating system credential store:
    • macOS Keychain.
    • Windows Credential Manager.
  • Process output, request sizes, search scope, and concurrency are bounded.
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →