Rayven122 MCP

Tumiki MCP HTTP 适配器

语言日语 | 英国 英语

目录

• 概要
• 安装
• 使用示例
• 命令行选项
• 开发
• 许可证

______________________________________________________________________

概要

将stdio MCP服务器作为HTTP端点公开的Go实现代理服务器

主要特点

• ✅ 轻便简单的stdio代理
• ✅ 立即启动： --stdio仅通过标志即可启动
• ✅ 动态设置可从HTTP头部设置环境变量和参数（支持流式HTTP）
• ✅ 自定义头部映射可以使用完全自定义的头部名称来指定环境变量和参数

📖 技术细节系统架构、组件设计、安全设计等的详细内容 docs/DESIGN.md（文件名，可译为“文档/设计说明.md”或保持原样，因为文件名通常不翻译） 请参考。

______________________________________________________________________

安装

已构建的二进制文件（推荐）

请从官网下载最新版本。

macOS / Linux（操作系统）

# 最新版を自動ダウンロード＆インストール
curl -sL https://github.com/rayven122/tumiki-mcp-http-adapter/releases/latest/download/tumiki-mcp-http_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv tumiki-mcp-http /usr/local/bin/

# 確認
tumiki-mcp-http --help

Windows

发布页面请从（相应位置）下载Windows版的zip文件并解压。

去安装

# Go がインストール済みの場合
go install github.com/rayven122/tumiki-mcp-http-adapter/cmd/tumiki-mcp-http@latest

# 確認
tumiki-mcp-http --help

注意: $GOPATH/bin （通常 ~/go/bin请确认该路径是否包含在PATH中。

从源代码构建

# リポジトリをクローン
git clone https://github.com/rayven122/tumiki-mcp-http-adapter.git
cd tumiki-mcp-http-adapter

# ビルド
task build

# バイナリを PATH に配置（オプション）
sudo cp bin/tumiki-mcp-http /usr/local/bin/

# 確認
tumiki-mcp-http --help

______________________________________________________________________

使用示例

文件系统服务器

# 起動
tumiki-mcp-http \
  --stdio "npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Documents"

# テスト
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

GitHub服务器（带环境变量）

# 起動
tumiki-mcp-http \
  --stdio "npx -y @modelcontextprotocol/server-github" \
  --env "GITHUB_TOKEN=ghp_xxxxx"

# テスト
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_repositories",
      "arguments": {"query": "language:go"}
    }
  }'

头部映射（动态设置）

可以从HTTP请求的头部动态设置环境变量和命令行参数。

步骤1：在CLI启动时定义映射

tumiki-mcp-http --stdio "npx -y server-slack" \
  --header-env "X-Slack-Token=SLACK_TOKEN" \
  --header-arg "X-Team-Id=team-id" \
  --header-arg "X-Channel=channel"

步骤2：在发送HTTP请求时传递实际值

curl -X POST http://localhost:8080/mcp \
  -H "X-Slack-Token: xoxp-xxxxx" \
  -H "X-Team-Id: T123" \
  -H "X-Channel: general" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

执行结果：

# 実行されるコマンド
npx -y server-slack --team-id T123 --channel general

# 設定される環境変数
SLACK_TOKEN=xoxp-xxxxx

______________________________________________________________________

命令行选项

选项列表

通过环境变量进行设置

服务器的启动设置也可以通过环境变量来指定。

# 例: 環境変数でホスト指定、コマンドラインオプションでポート指定
HOST=127.0.0.1 tumiki-mcp-http --port 3000 --stdio "npx -y server-filesystem /data"

______________________________________________________________________

开发

有关开发环境的设置、测试、编码规范等详细信息，请参阅以下内容：

开发指南（docs/DEVELOPMENT.md）

______________________________________________________________________

许可证

MIT许可证 - 详情见 许可证 请参考