goblin (Talking Threads)

地精MCP网关

开发人员第一个MCP网关，将多个MCP服务器聚合在一个统一的端点后面

   ](https://www.npmjs.com/package/@talkingthreads/goblin) \![License\]\[许可证url\]

_极速性能•热装•企业就绪_

______________________________________________________________________

关于

Goblin已准备好生产 模型上下文协议（MCP）网关 这解决了代理人工智能系统中的工具蔓延、上下文膨胀和脆弱的集成问题。Goblin使用Bun、TypeScript、Hono和MCP SDK构建，提供低于50ms的延迟目标和开发人员优先体验，包括实时TUI仪表板、结构化日志记录和全面的可观察性。

为什么是妖精？

• 统一接口：来自多个MCP后端的单端点聚合工具、提示和资源
• 热重新加载：配置更改以原子方式应用，无需重新启动
• 多运输：STDIO、HTTP、SSE和带自动连接池的流式HTTP
• 企业就绪：1000多项测试、CI烟雾测试、性能基准测试

______________________________________________________________________

特性

核心能力

• 🔌 统一聚合 --来自多个MCP服务器的工具、提示和资源的单一端点
• 🛣️ 智能路由 --带超时强制和错误映射的命名空间工具调用
• 🚀 多运输 --STDIO、HTTP、SSE和带自动连接池的流式HTTP
• ⚡ 热重新加载 --配置更改以原子方式应用，无需重新启动（HTTP模式）或通过SIGHUP（STDIO模式）
• 📊 完全可观察性 --结构化日志记录、自定义指标和实时TUI仪表板
• ✅ 企业就绪 --1000多项测试，CI烟雾测试，性能基准测试

______________________________________________________________________

快速开始

1.安装

git clone https://github.com/TalkingThreads/goblin.git
cd goblin
bun install

2.配置

创建一个 config.json 文件：

{
  "servers": [
    {
      "name": "filesystem",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
      "enabled": true
    }
  ],
  "gateway": {
    "port": 3000,
    "host": "127.0.0.1"
  }
}

3.跑步

# Development mode (with hot reload)
bun run dev

# Production mode
bun run build
bun run start

# With TUI dashboard
goblin start --tui

# STDIO mode (for Claude CLI integration)
goblin stdio

就是这样！地精现在正在奔跑 http://127.0.0.1:3000.

• 超文本传输协议: http://127.0.0.1:3000/mcp
• 上海证券交易所: http://127.0.0.1:3000/sse

______________________________________________________________________

安装

来源

git clone https://github.com/TalkingThreads/goblin.git
cd goblin
bun install
bun run build

先决条件

______________________________________________________________________

文档

______________________________________________________________________

CLI命令

网关管理

goblin start              # Start the gateway (default: HTTP mode)
goblin start --tui       # Start with TUI dashboard
goblin start --port 8080 # Custom port
goblin restart           # Graceful restart
goblin stop              # Graceful shutdown

服务器管理

goblin servers                    # List all servers
goblin servers add    # Add a new server
goblin servers remove       # Remove a server
goblin servers enable       # Enable a disabled server
goblin servers disable      # Disable a server

工具操作

goblin tools list                 # List all available tools
goblin tools invoke  --args '{"path": "/tmp"}'
goblin tools describe       # Show tool schema

配置

goblin config validate            # Validate configuration
goblin config show                # Display current config
goblin config reload              # Hot reload config

监控

goblin status                     # Gateway status
goblin health                     # Health check
goblin logs                       # Show logs
goblin logs -f                    # Follow logs
goblin metrics                    # Performance metrics

壳牌完井

# Bash
goblin completion bash >> ~/.bashrc

# Zsh
goblin completion zsh >> ~/.zshrc

# Fish
goblin completion fish > ~/.config/fish/completions/goblin.fish

看 CLI参考 以获取完整的文档。

______________________________________________________________________

建筑

┌─────────────────────────────────────────────────────────────┐
│                      Goblin MCP Gateway                       │
│                                                              │
│  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐ │
│  │  Client  │──▶│  HTTP    │──▶│  Router  │──▶│ Registry │ │
│  │  (MCP)   │   │ Gateway  │   │          │   │          │ │
│  └──────────┘   └──────────┘   └──────────┘   └──────────┘ │
│                                      │              │        │
│                                      ▼              ▼        │
│  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐ │
│  │  Client  │◀──│   TUI    │◀──│ Metrics  │◀──│ Transport│ │
│  │  (MCP)   │   │Dashboard │   │          │   │   Pool   │ │
│  └──────────┘   └──────────┘   └──────────┘   └──────────┘ │
│                                                              │
└─────────────────────────────────────────────────────────────┘
         │                    │                    │
         ▼                    ▼                    ▼
  ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
  │ MCP Server 1 │     │ MCP Server 2 │     │ MCP Server N │
  │ (Filesystem) │     │ (Git)        │     │ (Custom)     │
  └──────────────┘     └──────────────┘     └──────────────┘

看 建筑 获取详细的组件文档。

______________________________________________________________________

客户端传输类型

STDIO传输

用于将MCP服务器作为子进程运行的基于本地子进程的传输：

{
  "name": "filesystem",
  "transport": "stdio",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
  "enabled": true
}

HTTP传输

用于连接到基于HTTP的MCP服务器的简单HTTP传输：

{
  "name": "remote-server",
  "transport": "http",
  "url": "http://localhost:3001/mcp",
  "enabled": true
}

苏格兰和南方能源公司运输

服务器推送通知的服务器发送事件传输：

{
  "name": "sse-server",
  "transport": "sse",
  "url": "http://localhost:3002/sse",
  "enabled": true
}

可流式HTTP传输

具有会话管理、自动重新连接和自定义标头的有状态HTTP传输：

{
  "name": "streamable-server",
  "transport": "streamablehttp",
  "url": "http://localhost:3003/mcp",
  "headers": {
    "Authorization": "Bearer your-token-here"
  },
  "reconnect": {
    "enabled": true,
    "delay": 1000,
    "maxRetries": 5,
    "backoffMultiplier": 2
  },
  "enabled": true
}

______________________________________________________________________

服务器生命周期模式

Goblin支持后端MCP服务器的三种连接生命周期模式：

模式配置

添加 mode 属性到服务器配置：

{
  "name": "filesystem",
  "transport": "stdio",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
  "mode": "smart",
  "enabled": true
}

• 有状态的 （默认）：最适合频繁调用的服务器
• 聪明的：推荐默认值-闲置60秒后自动清理
• 无状态：最适合在偶尔调用时最大限度地减少内存使用

______________________________________________________________________

技术栈

______________________________________________________________________

贡献

我们欢迎捐款！请参阅 贡献.md 作为指导方针。

开发工作流程

1. 阅读 代理商.md 用于规范驱动的开发过程
2. 为新功能创建更改建议
3. 为您的更改编写测试
4. 确保所有测试通过： bun test
5. 提交拉取请求

预提交钩子

此项目使用 哈士奇 对于预提交钩子：

# Install hooks (runs automatically after bun install)
bun run prepare

挂钩检查：

• ✅ TypeScript类型检查(bun run typecheck)
• ✅ 生物植绒(bun run lint)
• ✅ 单元测试(bun test tests/unit/)

______________________________________________________________________

支持

• 📖️ 文档
• 💬
• 🐛
• 🔒 安全策略

______________________________________________________________________

许可证

______________________________________________________________________

相关文件

______________________________________________________________________

建于❤️ TalkingThreads团队