yone-k/zaim-api-mcp

Deployment & DevOps

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

10 stars 5 forks 품질 81 트렌드 32MIT

Repository Install

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

개요

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でファイルに保存するか、環境変数で渡します。サーバーは次の基準で認証情報を選びます。

설치

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

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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