mcp-jp — Japanese SMB SaaS connectors

日本の SMB 向け SaaS に対応した MCP サーバー集

Claude などの AI エージェントから、日本のクラウドサービスを自然言語で操作できるようにします。 公式 MCP が存在しないサービスへのコネクタを独自実装しています。

このリポジトリの狙いと収益化の考え方は 戦略メモ を参照。 その他の詳細ドキュメントは docs/README.md にまとめています。

コネクタ一覧

日本SMB向け（独自実装）

グローバルSaaS（独自実装）

公式MCPが提供されているサービス

以下は公式 MCP サーバーが提供されているため、そちらを利用してください。

これらのサービスについては、過去に独自実装したコネクタを archive/ に移動し、メンテナンス対象外としています。新規利用では公式 MCP を使ってください。

セットアップ

必要なもの

• Python 3.10 以上
• Claude Desktop または MCP 対応クライアント

インストール

各コネクタは独立したパッケージです。使いたいコネクタのディレクトリで pip install -e . を実行します。

# 例: SmartHR コネクタをインストール
cd smarthr
pip install -e .

Claude Desktop への設定

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集します。

{
  "mcpServers": {
    "smarthr": {
      "command": "smarthr-mcp",
      "env": {
        "SMARTHR_CLIENT_ID": "your_client_id",
        "SMARTHR_CLIENT_SECRET": "your_client_secret", # pragma: allowlist secret
        "SMARTHR_SUBDOMAIN": "your_subdomain"
      }
    }
  }
}

各コネクタの詳細なセットアップ手順・必要な環境変数は、各ディレクトリの README.md を参照してください。

構造

各コネクタは以下の構成で統一されています。

{connector}/
├── pyproject.toml          # パッケージ設定
├── README.md               # セットアップ手順・ツール一覧
└── src/{connector}_mcp/
    ├── __init__.py
    ├── _http.py            # 共通ヘルパー（レスポンス整形・エラー処理）
    └── server.py           # MCP サーバー実装

_http.py は全コネクタ共通（外部依存を増やさないため各パッケージに同梱）。 API エラーは生のスタックトレースではなく原因と対処を示すメッセージに変換し、 大きすぎるレスポンスは LLM のコンテキストを溢れさせないよう切り詰める。

公式 MCP が提供されたサービスのコネクタは archive/ に退避している。

コントリビュート

新しいコネクタのリクエストや PR を歓迎します。

「このSaaSを繋ぎたい」だけでも歓迎です — コネクタのリクエストはこちら。非エンジニアの方は note のコメントからでも構いません。需要として記録し、重なっているものから優先して実装します。

コネクタ追加の前に:

• 候補選定マトリクスでスコアリングしてから着手してください（公式MCP不在の持続性・需要・検証可能性・日本SMB密着度）
• 対象サービスの公式 MCP が存在しないか確認してください（公式MCP一覧を参照）。既にある場合は作らない
• 公開された REST API ドキュメントが存在し、テスト用クレデンシャルを取得できることを確認してください

実装のガイドライン:

• 1 コネクタあたり 5 つ前後のツールを実装する
• 認証情報は環境変数で渡す
• レスポンス整形・エラー処理は共通ヘルパー _http.py（format_response / error_response）を使う
• 各コネクタに README.md（セットアップ手順・ツール一覧・使用例）を含める
• 既存のコネクタ（例: payjp/）を参考にパターンを合わせる

ライセンス

MIT License