Metadata-Version: 2.5
Name: gbrain-mcp-proxy
Version: 0.1.0
Summary: MCP proxy for gbrain with automatic OAuth token refresh
Project-URL: Homepage, https://github.com/shiyulong/gbrain-mcp-proxy
Author: shiyulong
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: fastmcp<5.0,>=2.0
Requires-Dist: httpx<1.0,>=0.27
Description-Content-Type: text/markdown

# gbrain-mcp-proxy

`gbrain-mcp-proxy` 是一个连接远程 gbrain MCP 服务的 stdio 代理，使用 OAuth `client_credentials` 获取访问令牌，并在令牌过期前自动刷新。

## 安装与运行

无需安装即可运行：

```bash
uvx gbrain-mcp-proxy
```

也可以安装后运行：

```bash
pip install gbrain-mcp-proxy
gbrain-mcp-proxy
```

## 环境变量

运行前配置以下环境变量：

```bash
export GBRAIN_URL="https://your-gbrain-host/mcp"
export GBRAIN_CLIENT_ID="your-client-id"
export GBRAIN_CLIENT_SECRET="your-client-secret"
```

`GBRAIN_URL` 是 gbrain MCP 端点；`GBRAIN_CLIENT_ID` 和 `GBRAIN_CLIENT_SECRET` 是 OAuth 客户端凭据。代理会自动发现 token endpoint，也可通过可选的 `GBRAIN_TOKEN_URL` 显式指定。

## MCP 客户端配置

Qoder、Hermes 等使用 `mcp.json` 的客户端可添加：

```json
{
  "mcpServers": {
    "gbrain": {
      "command": "uvx",
      "args": ["gbrain-mcp-proxy"],
      "env": {
        "GBRAIN_URL": "https://your-gbrain-host/mcp",
        "GBRAIN_CLIENT_ID": "your-client-id",
        "GBRAIN_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}
```
