@macnishio/windsurf-mcp-server

WindsurfMCP360

Claude Desktop用のAWSベースMCPサーバー

概要

WindsurfMCP360は、Claude Desktopと連携する高性能なModel Context Protocol (MCP) サーバーです。AWSのサーバーレスアーキテクチャを活用し、WebSocketを通じて安定した通信を実現します。

特徴

• AWSサーバーレスアーキテクチャ: Lambda、API Gateway、DynamoDBを活用
• 安定したWebSocket通信: Claude Desktopとの信頼性の高い接続
• 簡単な設定: 設定ファイルの自動生成
• デプロイツール内蔵: AWS環境への簡単なデプロイ

インストール

# グローバルインストール
npm install -g windsurf-mcp-server

# または、npxを使用
npx windsurf-mcp-server

使用方法

基本的な起動

# グローバルインストールした場合
windsurf-mcp-server start

# または、npxを使用
npx windsurf-mcp-server start

AWSインフラストラクチャのデプロイ

# AWSプロファイルを指定してデプロイ
windsurf-mcp-server deploy --profile your-aws-profile

# リージョンとステージを指定
windsurf-mcp-server deploy --profile your-aws-profile --region ap-northeast-1 --stage prod

Claude Desktop用の設定の生成

# 設定JSONを表示
windsurf-mcp-server config

# 特定ステージ用の設定を表示
windsurf-mcp-server config --stage dev

Claude Desktop設定

以下の設定をClaude Desktopの設定ファイルに追加してください：

{
  "mcpServers": {
    "windsurf-mcp-server": {
      "command": "npx",
      "args": ["windsurf-mcp-server", "start"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO",
        "AWS_PROFILE": "your-aws-profile"
      },
      "autoApprove": []
    }
  }
}

AWS環境変数

• AWS_PROFILE: AWS CLIプロファイル名
• AWS_REGION: AWSリージョン（デフォルト: ap-northeast-1）
• STAGE: デプロイステージ（デフォルト: prod）
• WEBSOCKET_ENDPOINT: WebSocketエンドポイントのURL
• CONNECTION_TABLE_NAME: DynamoDBテーブル名

uvxを使用する方法

uvxコマンドを使用して実行することもできます：

{
  "mcpServers": {
    "macnishio.windsurf-mcp-server": {
      "command": "uvx",
      "args": ["macnishio.windsurf-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO",
        "AWS_PROFILE": "your-aws-profile"
      },
      "autoApprove": []
    }
  }
}

ログ

ログは以下の場所に保存されます：

• デフォルト: ./logs/windsurf-mcp.log
• カスタム: 環境変数 LOG_DIR と LOG_FILE で指定

ライセンス

MIT

作者

MacNishio