MCP服务器STDIO模式工具

Finch-MCP-STDIO是一个专门用于在STDIO模式下运行MCP服务器的工具,支持自定义环境变量和卷挂载,适用于需要直接通过标准输入/输出与MCP服务器通信的场景。

  • by mikeyobrien
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 mikeyobrien/finch-mcp-rust

使用说明

Finch MCP STDIO

一种在STDIO模式下运行MCP(模型上下文协议)服务器的专用工具,使用 芬奇.

特性

  • 以STDIO模式运行MCP服务器,通过标准输入/输出进行直接通信
  • 支持自定义环境变量和卷装载
  • 使用Ctrl+C进行优雅的容器终止
  • 采用Rust构建,性能可靠

先决条件

  • 锈 1.70或更高版本
  • 芬奇 (用于集装箱管理)
  • 支持STDIO模式的MCP服务器映像

安装

来源

克隆存储库并构建项目:

git clone https://github.com/yourusername/finch-mcp-stdio.git
cd finch-mcp-stdio
cargo build --release

编译后的二进制文件将在 target/release/finch-mcp-stdio.

使用货物

cargo install --git https://github.com/yourusername/finch-mcp-stdio.git

用法

基本用法

在STDIO模式下运行MCP服务器:

finch-mcp-stdio my-mcp-image:latest

使用环境变量

finch-mcp-stdio my-mcp-image:latest -e API_KEY=xyz123 -e DEBUG=true

带卷装

finch-mcp-stdio my-mcp-image:latest -v /host/path:/container/path

完整选项

USAGE:
    finch-mcp-stdio [OPTIONS] <IMAGE>

ARGS:
    <IMAGE>    MCP server image to run

OPTIONS:
    -e, --env <KEY=VALUE>...                Environment variables to pass to the container
    -v, --volume <HOST_PATH:CONTAINER_PATH>...    Mount volumes in the container
    -h, --help                              Print help information
    -V, --version                           Print version information
    -v, --verbose                           Enable verbose logging (repeat for more verbosity)

发展

运行测试

# Run unit tests
cargo test

# Run integration tests (requires Finch)
cargo test -- --ignored

建筑文件

cargo doc --no-deps --open

运作原理

  1. 该工具验证Finch是否已安装并可用
  2. 它确保Finch VM正在运行
  3. 它在启用STDIO模式的情况下执行指定的容器(MCP_STDIO=true)
  4. 标准输入/输出流在应用程序和容器之间通过管道传输
  5. 该工具处理信号中断以实现优雅终止

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

贡献

欢迎投稿!请随时提交拉取请求。