AWS Knowledge MCP Proxy

概要 (Overview )

AWS公式のAWS Knowledge MCP Server (aws-knowledge-mcp-server) がプロキシ環境下で動作しないため、 プロキシ対応可能なClientとして実装した。 公式とセットアップ方法が異なるが、使い方は同じなので、公式のWebサイトを参照のこと。

Since the official AWS Knowledge MCP Server (aws-knowledge-mcp-server) does not work in proxy environments, this has been implemented as a proxy-capable client. The setup method differs from the official one, but the usage is the same, so please refer to the AWS Knowledge MCP Server official website.

前提条件 (Prerequisites)

• Node.js

動作確認済 (Tested on)

• MacOS Ventura 15.0.1
  • Node.js v20.11.1
  • Cursor v2.x
  • VS Code + Amazon Q Developer

セットアップ (Setup)

1. ソースコードをローカルに置く

cd {Your Working Dir}
git clone https://github.com/f-kana/aws-knowledge-mcp-proxy.git

2. 依存関係のインストール

cd aws-knowledge-server-proxy
npm install

3. MCP設定ファイルの更新

.amazonq/mcp.json や .cursor/mcp.json などに以下を追加：

方法1: 環境変数を直接指定（推奨）

{
  "mcpServers": {
    "aws-knowledge-mcp-proxy": {
      "command": "node",
      "args": [
        "/path/to/aws-knowledge-mcp-proxy/index.js"
      ],
      "env": {
        "HTTP_PROXY": "http://proxy.example.com:8080",
        "HTTPS_PROXY": "http://proxy.example.com:8080",
        "NO_PROXY": "localhost,127.0.0.1"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

方法2: システム環境変数を使用

システムレベルで環境変数を設定している場合、envセクションは省略可能です：

# ~/.bashrc
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1

{
  "mcpServers": {
    "aws-knowledge-mcp-with-proxy": {
      "command": "node",
      "args": [
        "/path/to/aws-knowledge-server-proxy/index.js"
      ],
      "timeout": 60000,
      "disabled": false
    }
  }
}

備考

• プロキシを使わない場合は設定JSONから"HTTP_PROXY": "http://proxy.example.com:8080"等を削除する（この場合、環境変数のHTTP_PROXYが使われる、環境変数未設定ならPROXY無しになる）。
• *MCPツール名を"aws-knowledge-mcp-server-proxy"のようにすると、ツール名+Function名が制限である60文字を越えるらしく、警告が出る。

ライセンス (License)

MIT

Author

f-kana