Ekispert MCP Remote Server

駅すぱあと Remote MCP Server on Cloudflare Workers

駅すぱあとAPIを使用した経路検索とPDF生成を行うリモートMCPサーバーです。
Cloudflare Workersで動作し、インターネット経由でアクセス可能です。

🚀 特徴

リモートアクセス: インターネット経由でどこからでもアクセス可能
サーバーレス: Cloudflare Workersで自動スケーリング
セキュア: OAuth認証による安全なアクセス制御
高速PDF生成: Browser Rendering APIによる高速レンダリング
永続ストレージ: R2によるPDFの保存と配信

📋 必要なもの

Cloudflareアカウント
駅すぱあとAPIキー
Node.js 18以上
Wrangler CLI

🛠️ セットアップ

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

npm install

2. Cloudflareの設定

KV Namespaceの作成

wrangler kv:namespace create SESSION_STORE
wrangler kv:namespace create SESSION_STORE --preview

R2 Bucketの作成

wrangler r2 bucket create ekispert-pdf-storage

3. 環境変数の設定

# 駅すぱあとAPIキーの設定
wrangler secret put EKISPERT_API_KEY

4. wrangler.tomlの更新

作成されたKV NamespaceのIDをwrangler.tomlに記入:

[[kv_namespaces]]
binding = "SESSION_STORE"
id = "your_actual_kv_namespace_id"  # ← ここを更新
preview_id = "your_actual_preview_kv_namespace_id"  # ← ここを更新

🚀 デプロイ

ローカル開発

npm run dev

本番環境へのデプロイ

npm run deploy

デプロイ後、以下のURLでアクセス可能になります:

https://ekispert-mcp-remote-server.<your-subdomain>.workers.dev/

🔌 MCP クライアントとの接続

Claude Desktopの設定

%APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "ekispert-mcp-remote-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ekispert-mcp-remote-server.2122-2.workers.dev/mcp"
      ]
    }
  }
}

重要な接続エンドポイント

MCPエンドポイント: https://ekispert-mcp-remote-server.2122-2.workers.dev/mcp
ヘルスチェック: https://ekispert-mcp-remote-server.2122-2.workers.dev/

⚠️ 注意: MCPクライアントは /mcp エンドポイントを使用してください。

WebSocket接続の例

const ws = new WebSocket('wss://ekispert-mcp-remote-server.2122-2.workers.dev/mcp/ws');

ws.onopen = () => {
  // Send MCP requests
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/list',
    id: 1
  }));
};

ws.onmessage = (event) => {
  const response = JSON.parse(event.data);
  console.log('MCP Response:', response);
};

📚 利用可能なツール

search_routes

経路検索を実行します。

{
  "from": "新宿",
  "to": "東京",
  "via": "品川",
  "date": "20250818",
  "time": "0900",
  "searchType": "departure"
}

generate_pdf

検索結果からPDFを生成します。

{
  "routeData": { /* 経路データ */ },
  "outputFileName": "route_20250818.pdf"
}

🏗️ アーキテクチャ

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│ MCP Client  │────▶│ Cloudflare Worker│────▶│ Ekispert API│
└─────────────┘     └──────────────────┘     └─────────────┘
                            │
                    ┌───────▼────────┐
                    │ Durable Objects│
                    │  (State Mgmt)  │
                    └───────┬────────┘
                            │
                ┌───────────┼───────────┐
                ▼           ▼           ▼
          ┌──────────┐ ┌─────────┐ ┌──────────┐
          │    R2    │ │   KV    │ │ Browser  │
          │ Storage  │ │ Storage │ │Rendering │
          └──────────┘ └─────────┘ └──────────┘

🔒 セキュリティ

OAuth 2.0による認証
APIキーの暗号化保存
Rate limiting実装
CORS設定

📊 料金

Cloudflare Workersの無料枠:

100,000リクエスト/日
10ms CPU時間/リクエスト
R2: 10GB ストレージ

詳細はCloudflare価格ページを参照。

🐛 トラブルシューティング

Browser Rendering APIが使えない場合

Browser Rendering APIは有料プランが必要です。代替として、外部のPDF生成APIを使用するか、HTMLレスポンスのみを返すことも可能です。

KV Namespaceエラー

wrangler kv:namespace list

でNamespace IDを確認し、wrangler.tomlを更新してください。

R2アクセスエラー

wrangler r2 bucket list

でバケットの存在を確認してください。

📄 ライセンス

MIT License

🤝 コントリビューション

Issue、Pull Requestは歓迎します！

📞 サポート

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables route search and PDF generation using Japan's Ekispert API through a remote MCP server. Deployed on Cloudflare Workers with secure OAuth authentication and persistent PDF storage via R2.

Related MCP Servers

@sanderkooger/mcp-server-ragdocs
sanderkooger
-
security
A
license
-
quality
An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context. Uses Ollama or OpenAI to generate embeddings. Docker files included
Last updated -
3
22
TypeScript
MIT License
ReActMCP Web Search
mshojaei77
-
security
F
license
-
quality
An MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.
Last updated -
141
Python
Autodocument MCP Server
PARS-DOE
-
security
A
license
-
quality
An MCP server that automatically generates documentation, test plans, and code reviews for code repositories by analyzing directory structures and code files using AI models via OpenRouter API.
Last updated -
5
TypeScript
Creative Commons Zero v1.0 Universal
Claude AI Documentation Assistant
XPE-7
-
security
F
license
-
quality
An MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.
Last updated -
Python

View all related MCP servers