Tumiki Proxy

MCPAI代理

提供方 rayven122

AI代理 未标注 无需鉴权 社区 / 第三方 Claude

tumiki-proxy是一个用于记录和分析MCP(Model Context Protocol)服务器流量的透明代理工具,支持多种传输协议和认证方式,适用于调试和性能分析场景。

一句话选型结论

按资料字段整理

Tumiki Proxy 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP协议TypeScript本地部署日志记录调试工具性能分析透明代理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Tumiki Proxy当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方rayven122上游标注的维护方 rayven122
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.1 KB
来自项目仓库与上游目录的原文,未做删改

tumiki代理

MCP (Model Context Protocol) 服务器透明记录代理。Claude Code 和后端服务器之间的所有MCP将流量记录在本地文件中,帮助调试和分析。

特徴

  • 支持多传输: stdio、HTTP/StreamableHTTP、HTTP/SSEに対応
  • 公式SDK使用: @modelcontextprotocol/sdk基于
  • 自动回退: StreamableHTTP → SSE自动切换
  • 认证对应: HTTP面向基本服务器API密钥支持
  • 透过的: MCP不更改协议的零影响包装器
  • 効率的:异步缓冲和批处理的最小开销
  • 型安全: TypeScript完全实施
  • 统一日志格式:在所有传输中NDJSON采用形式

安装

方法1: Homebrew(macOS/Linux - 推奨)

macOS或Linux对于用户Homebrew中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积```bash

Tapを追加してインストール

brew tap rayven122/tumiki-proxy https://github.com/rayven122/tumiki-proxy
brew install tumiki-proxy

アップデート

brew update
brew upgrade tumiki-proxy


了解更多信息Homebrew安装指南来修改标记元素的显示属性。

### 方法2:二进制分发

GitHub的,之Releases从页面下载平台的已构建二进制文件:```bash
# macOS (ARM64)
curl -L -o tumiki-proxy https://github.com/rayven122/tumiki-proxy/releases/latest/download/tumiki-proxy-macos-arm64
chmod +x tumiki-proxy

# macOS (x64)
curl -L -o tumiki-proxy https://github.com/rayven122/tumiki-proxy/releases/latest/download/tumiki-proxy-macos-x64
chmod +x tumiki-proxy

# Linux (x64)
curl -L -o tumiki-proxy https://github.com/rayven122/tumiki-proxy/releases/latest/download/tumiki-proxy-linux-x64
chmod +x tumiki-proxy

# Windows (x64)
# PowerShellで実行:
Invoke-WebRequest -Uri "https://github.com/rayven122/tumiki-proxy/releases/latest/download/tumiki-proxy-win-x64.exe" -OutFile "tumiki-proxy.exe"

方法3:从源构建

Bun使用(建议-独立二进制)```bash

リポジトリをクローン

git clone https://github.com/rayven122/tumiki-proxy.git
cd tumiki-proxy

Bunで依存関係のインストールとビルド

bun install
bun run build

スタンドアロンバイナリの生成

bun run build:binary

→ tumiki-proxy バイナリが生成されます


#### Node.js使用(传统方法)```bash
# リポジトリをクローン
git clone https://github.com/rayven122/tumiki-proxy.git
cd tumiki-proxy

# 依存関係のインストールとビルド
npm install
npm run build

# Node.js経由で実行
node dist/index.js [args...]

使用方法

stdio 模式(本地MCP服务器)

stdin/stdout 中所述的工具,调整墙的布局和几何形状MCP对于服务器:```bash

ログファイルの場所を指定

export TUMIKI_LOG_FILE="./mcp-filesystem.log"

stdioベースのMCPサーバーをプロキシ経由で実行

tumiki-proxy npx -y @modelcontextprotocol/server-filesystem /path/to/dir


### SSEStreamable HTTP 模式(远程MCP服务器)

HTTP可通过的远程MCP对于服务器:```bash
export TUMIKI_LOG_FILE="./mcp-context7.log"
export CONTEXT7_API_KEY="your-api-key"  # オプション
tumiki-proxy --http https://mcp.context7.com/mcp

Claude Code 设定

.mcp.json 建议使用文件进行设置。在项目根目录中 .mcp.json 中所述修改相应参数的值。

设定例(.mcp.json)```json

{
"mcpServers": {
"filesystem": {
"command": "./tumiki-proxy",
"args": [
"npx",
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/dir"
],
"env": {
"TUMIKI_LOG_FILE": "/tmp/mcp-filesystem.log"
}
},
"context7": {
"command": "./tumiki-proxy",
"args": [
"--http",
"https://mcp.context7.com/mcp"
],
"env": {
"TUMIKI_LOG_FILE": "/tmp/mcp-context7.log",
"CONTEXT7_API_KEY": "your-api-key"
}
}
}
}


**注意**:使用二进制版本时 `./tumiki-proxy` 中所述修改相应参数的值。Node.js使用版本时 `node dist/index.js` 的command 选项卡页面上创建或编辑条目args 之后由应用程序进行调用。

## 设定

### 环境变数

|变量|必需|默认|说明|
| `TUMIKI_LOG_FILE` 是,日志文件路径
| `TUMIKI_LOG_BUFFER_SIZE` 不,不,不,不,不,不,不,不
| `TUMIKI_LOG_BATCH_SIZE` 不,不,不,不,不,不,不
| `TUMIKI_LOG_BATCH_TIMEOUT_MS` 否100刷新间隔(毫秒)

### 认证用环境变量(SSE・Streamable HTTP 模式)

|变数|说明|
|----------|-------------|
| `CONTEXT7_API_KEY` | Context7专用API关键字

| `MCP_API_KEY` |通用MCP API关键字
| `API_KEY` 用于回退API关键字

### 自定义设置示例```bash
export TUMIKI_LOG_FILE="./mcp.log"
export TUMIKI_LOG_BUFFER_SIZE=500
export TUMIKI_LOG_BATCH_SIZE=50
export TUMIKI_LOG_BATCH_TIMEOUT_MS=200

tumiki-proxy your-mcp-server

日志格式

日志换行符JSON(NDJSON)格式:```json
{"timestamp":"2024-01-15T10:30:00.000Z","type":"request","direction":"client→backend","backendCmd":"npx","message":{"jsonrpc":"2.0","id":1,"method":"tools/list"},"raw":"{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}"}
{"timestamp":"2024-01-15T10:30:00.100Z","type":"response","direction":"backend→client","backendCmd":"npx","message":{"jsonrpc":"2.0","id":1,"result":{"tools":[...]}},"raw":"{\"jsonrpc\":\"2.0\",\"id\":1,\"result\":{\"tools\":[...]}}"}
{"timestamp":"2024-01-15T10:30:00.150Z","type":"info","backendCmd":"--http","message":"Connected using StreamableHTTP transport"}


### 日志条目类型

- `request`:客户端-后端-MCP服务器)
- `response`:后端-客户端(MCP服务器-Claude Code)
- `stderr`:后端错误输出(仅限stdio模式)
- `info`:代理生命周期事件(启动、退出和连接信息)
- `error`:代理错误

## 体系结构

### stdio 模式```
┌─────────────┐
│ Claude Code │
└──────┬──────┘
│ stdin/stdout (JSON-RPC)
↓
┌────────────────────┐
│  tumiki-proxy      │
│  ┌──────────────┐  │
│  │ FileLogger   │──┼─→ ローカルログファイル (NDJSON)
│  └──────────────┘  │
│  ┌──────────────┐  │
│  │ spawn + pipe │  │
│  └──────────────┘  │
└────────┬───────────┘
│ stdin/stdout (透過的)
↓
┌─────────────────┐
│  MCP Server     │
│  (stdio)        │
└─────────────────┘

SSEStreamable HTTP 模式```

┌─────────────┐
│ Claude Code │
└──────┬──────┘
│ stdin/stdout
↓
┌────────────────────┐
│ tumiki-proxy │
│ ┌──────────────┐ │
│ │ FileLogger │──┼─→ ローカルログファイル (NDJSON)
│ └──────────────┘ │
│ ┌──────────────┐ │
│ │ Stdio Server │ │
│ │ Transport │ │
│ └──────────────┘ │
│ ┌──────────────┐ │
│ │StreamableHTTP│ │
│ │/SSE Client │ │
│ └──────────────┘ │
└────────┬───────────┘
│ Streamable HTTP/SSE
↓
┌─────────────────┐
│ MCP Server │
│ (HTTP) │
└─────────────────┘


## 故障排除

### SSEStreamable HTTP 模式连接确认

可以在日志文件中查看传输选择:```bash
# Streamable HTTP が使用された場合
{"type":"info","message":"Connected using StreamableHTTP transport"}

# SSE にフォールバックした場合
{"type":"info","message":"StreamableHTTP connection failed, falling back to SSE transport"}
{"type":"info","message":"Connected using SSE transport"}

HTTP服务器连接错误

症状: MCP服务器failed 状态

诊断和解决方案:

  1. API密钥问题(需要认证的服务器时)
  • 服务提供商API获取密钥
  • 设置适当的环境变量(CONTEXT7_API_KEY、MCP_API_KEY,或 API_KEY)
  • Claude Code 重新启动
  1. 传输连接错误
  • 在日志文件中查看详细的错误消息
  • StreamableHTTP 和SSE 如果两者都失败,请检查网络连接
  • 检查防火墙设置

未创建日志文件

确认事项:

  1. TUMIKI_LOG_FILE 是否设置了环境变量
  2. 日志文件路径是否具有写权限
  3. 日志文件是否已在另一进程中打开

开発

Bun的开发(推荐)```bash

依存関係のインストール

bun install

TypeScriptのビルド

bun run build

ウォッチモード

bun run dev

スタンドアロンバイナリの生成

bun run build:binary

→ tumiki-proxy バイナリが生成されます (57MB)

→ Bun runtime込みの完全なスタンドアロン実行ファイル

→ 外部ランタイム不要、高速起動

ビルド成果物のクリーンアップ

rm -rf dist tumiki-proxy


### Node.js使用开发```bash
# 依存関係のインストール
npm install

# TypeScriptのビルド
npm run build

# ウォッチモード
npm run dev

# ビルド成果物のクリーンアップ
rm -rf dist

技术仕样

二进制构建:

  • 工具:包1.x
  • 尺寸:约57MB (Bun runtime包含)
  • 起动时间:\<100ms
  • 互换性:macOS(x64/ARM64),Linux(x64),Windows(x64)
  • 依存关系:无(完全独立)

Node.js版:

  • 要件:Node.js>=18.0.0
  • 依存关系:@modelcontextprotocol/sdk
  • 実行: node dist/index.js

分发

欢迎分享!请随便Pull Request中所述修改相应参数的值。

许可证

MIT License - 了解更多信息LICENSE请参阅文件

将来的路线图

  • 云存储协作:针对云存储服务(S3、GCS等)HTTP上传
  • 日志查看器:用于查看和分析日志Electron贝斯GUI
  • 增强的分析功能: MCP分析流量模式和性能的内置工具
  • 包分发:用于更简单的安装NPM发布包

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Tumiki Proxy 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Tumiki Proxy 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Tumiki Proxy 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Tumiki Proxy 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Tumiki Proxy 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Tumiki Proxy 能提供哪些能力?

资料显示能力标签包括 调试工具、日志记录、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。