yone-k/zaim-api-mcp

Deployment & DevOps

This page was translated automatically. Technical details may differ from the original. View the original

10 stars 5 forks Quality 81 Trend 32MIT

Repository Install

ZaimのAPIを扱うための自作MCPサーバー

Overview

Zaimの家計簿データを取得・作成・更新・削除する、Go製のMCPサーバーです。MCPクライアントとはstdioで通信し、Zaim APIへのリクエストにはOAuth 1.0aの署名を付けます。 - 認証・ユーザー情報、家計簿、マスターデータを扱う18ツール - 公式Go MCP SDK v1.8.0と、Zaim API向けのGo SDK go-zaim v0.1.0を使用 - MCP 2026-07-28、2025-11-25、2025-06-18、2025-03-26、2024-11-05に対応 - JSON Schemaで入力・出力を検証し、結果をstructuredContentとJSONテキストで返却 - 小数金額やAPI由来の追加フィールドを保持 - GoバイナリとDockerによる起動ソースからビルドする場合はGo 1.26.2以上、Dockerで起動する場合はDockerが必要です。 Goのbinディレクトリへインストールする場合は、ソース取得後に次を実行します。サーバーはstdinからMCPメッセージを受け取り、stdoutへ応答します。起動ログはstderrへ出力します。 auth loginで保存した認証情報をDockerで使う方法は、「Dockerで保存した認証情報を使う」を参照してください。 Zaim APIへのリクエストには、OAuth 1.0aの署名に使う次の4つの値が必要です。 4つの値は、auth loginでファイルに保存するか、環境変数で渡します。サーバーは次の基準で認証情報を選びます。

Install

docker run --rm -i -e ZAIM_CONSUMER_KEY -e ZAIM_CONSUMER_SECRET -e ZAIM_ACCESS_TOKEN -e ZAIM_ACCESS_TOKEN_SECRET zaim-api-mcp

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "zaim-api": {
      "command": "/absolute/path/to/zaim-api-mcp/dist/zaim-api-mcp"
    }
  }
}