Zaim API MCP Server

MCP安全风控

提供方 yone-k

安全风控 未标注 混合方式 社区 / 第三方

Enables users to manage their Zaim household account data through OAuth 1.0a authentication. It provides 14 tools to retrieve, create, update, and delete financial records and master data like categories and accounts.

一句话选型结论

按资料字段整理

Zaim API MCP Server 属于安全风控类 MCP 服务器,传输方式未标注,混合方式,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式未标注 鉴权混合方式 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

未标注 混合方式
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好混合方式对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zaim API MCP Server当前 未标注 未标注 支持远程部署 无 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方yone-k上游标注的维护方 yone-k
分类安全风控本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式混合方式远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.6 KB
来自项目仓库与上游目录的原文,未做删改

Zaim API MCP Server

English README

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が必要です。

インストール・起動

ローカルバイナリ```bash

git clone https://github.com/yone-k/zaim-api-mcp.git
cd zaim-api-mcp

go build -o dist/zaim-api-mcp ./cmd/zaim-api-mcp
./dist/zaim-api-mcp


Goのbinディレクトリへインストールする場合は、ソース取得後に次を実行します。```bash
go install ./cmd/zaim-api-mcp
zaim-api-mcp

サーバーはstdinからMCPメッセージを受け取り、stdoutへ応答します。起動ログはstderrへ出力します。

Docker```bash

docker build -t zaim-api-mcp .
docker run --rm -i \
-e ZAIM_CONSUMER_KEY -e ZAIM_CONSUMER_SECRET \
-e ZAIM_ACCESS_TOKEN -e ZAIM_ACCESS_TOKEN_SECRET \
zaim-api-mcp


環境変数を設定したシェルから、Composeでも起動できます。```bash
docker compose build
docker compose run --rm -T zaim-api

auth loginで保存した認証情報をDockerで使う方法は、「Dockerで保存した認証情報を使う」を参照してください。

認証

Zaim APIへのリクエストには、OAuth 1.0aの署名に使う次の4つの値が必要です。

値 入手方法
Consumer Key・Consumer Secret Zaim Developersでアプリケーションを登録して発行
Access Token・Access Token Secret auth loginで、ブラウザからアクセスを許可して取得

4つの値は、auth loginでファイルに保存するか、環境変数で渡します。サーバーは次の基準で認証情報を選びます。

  • 4つの環境変数がすべて設定されていれば、環境変数を使います。
  • 4つとも未設定なら、auth loginで保存したファイルを使います。
  • 一部だけ設定されている場合は、保存したファイルと組み合わせずにエラーにします。

認証情報はツールの実行時に検証するため、未設定でもサーバーの起動とツール一覧の取得はできます。

auth loginで保存する

go installでインストールした場合は、次のコマンドを実行します。dist/にビルドした場合は、./dist/zaim-api-mcp auth loginを実行してください。```bash
zaim-api-mcp auth login


1. Consumer KeyとConsumer Secretを入力します。環境変数`ZAIM_CONSUMER_KEY`と`ZAIM_CONSUMER_SECRET`が設定されていれば、入力は求めません。
2. ブラウザでZaimの認可画面が開くので、アクセスを許可します。ブラウザが開かない場合は、表示されたURLを手動で開いてください。
3. コマンドがAccess Tokenを取得し、4つの値をファイルに保存します。

保存先は`~/.config/zaim-api-mcp/credentials.json`です。`XDG_CONFIG_HOME`を設定している場合は、`$XDG_CONFIG_HOME/zaim-api-mcp/credentials.json`に保存します。ファイルは本人だけが読み書きできる権限(0600)で作成します。

認可後のコールバックは`http://localhost:8080/callback`で受け取ります。ポートを変える場合は`--port`を指定してください。5分以内に許可しないと中断します。

保存した認証情報を使う場合、MCPクライアントの設定に`env`は不要です。これまで環境変数で設定していた場合は、MCPクライアントの設定から4つの`ZAIM_*`を削除してください。4つとも残っていると環境変数が使われ、一部だけ残っているとエラーになります。

### 環境変数で渡す

Access TokenとAccess Token Secretを別の方法で取得済みの場合は、4つの値を環境変数で渡せます。```bash
export ZAIM_CONSUMER_KEY=your_consumer_key
export ZAIM_CONSUMER_SECRET=your_consumer_secret
export ZAIM_ACCESS_TOKEN=your_access_token
export ZAIM_ACCESS_TOKEN_SECRET=your_access_token_secret

Dockerで保存した認証情報を使う

ホストでauth loginを実行してから、保存先のディレクトリを読み取り専用でマウントします。コンテナ内でファイルを読めるよう、--userでホストと同じユーザーIDを指定してください。```bash
docker run --rm -i \
--user "$(id -u):$(id -g)" \
-e XDG_CONFIG_HOME=/config \
-v "$HOME/.config/zaim-api-mcp:/config/zaim-api-mcp:ro" \
zaim-api-mcp


## MCPクライアント設定

サーバー名は従来の`zaim-api`を使います。`command`には、ビルドしたGoバイナリの絶対パスを指定してください。

`auth login`で認証情報を保存した場合の設定例です。```json
{
  "mcpServers": {
    "zaim-api": {
      "command": "/absolute/path/to/zaim-api-mcp/dist/zaim-api-mcp"
    }
  }
}

環境変数で渡す場合の設定例です。```json
{
"mcpServers": {
"zaim-api": {
"command": "/absolute/path/to/zaim-api-mcp/dist/zaim-api-mcp",
"env": {
"ZAIM_CONSUMER_KEY": "your_consumer_key",
"ZAIM_CONSUMER_SECRET": "your_consumer_secret",
"ZAIM_ACCESS_TOKEN": "your_access_token",
"ZAIM_ACCESS_TOKEN_SECRET": "your_access_token_secret"
}
}
}
}


Dockerを使う場合の設定例です。```json
{
  "mcpServers": {
    "zaim-api": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ZAIM_CONSUMER_KEY",
        "-e", "ZAIM_CONSUMER_SECRET",
        "-e", "ZAIM_ACCESS_TOKEN",
        "-e", "ZAIM_ACCESS_TOKEN_SECRET",
        "zaim-api-mcp"
      ],
      "env": {
        "ZAIM_CONSUMER_KEY": "your_consumer_key",
        "ZAIM_CONSUMER_SECRET": "your_consumer_secret",
        "ZAIM_ACCESS_TOKEN": "your_access_token",
        "ZAIM_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

ツール

分類 ツール 操作
認証 zaim_check_auth_status 認証状態の確認
ユーザー zaim_get_user_info プロフィール・統計情報の取得
家計簿 zaim_get_money_records フィルター・ページ指定で記録を取得
家計簿 zaim_create_payment 支出の作成
家計簿 zaim_create_income 収入の作成
家計簿 zaim_create_transfer 振替の作成
家計簿 zaim_update_money_record 記録の更新
家計簿 zaim_delete_money_record 記録の削除
家計簿 zaim_bulk_create_payments 支出の一括作成(最大100件)
家計簿 zaim_bulk_create_incomes 収入の一括作成(最大100件)
家計簿 zaim_bulk_create_transfers 振替の一括作成(最大100件)
家計簿 zaim_bulk_update_money_records 記録の一括更新(最大100件)
マスター zaim_get_user_categories ユーザーカテゴリ一覧
マスター zaim_get_user_genres ユーザージャンル一覧
マスター zaim_get_user_accounts 口座一覧
マスター zaim_get_default_categories デフォルトカテゴリ一覧
マスター zaim_get_default_genres デフォルトジャンル一覧
マスター zaim_get_currencies 通貨一覧

ツール名・引数・既定値と、成功時のJSON形式は従来どおりです。

  • 記録取得の既定値はlimit=20・page=1です。
  • 作成・更新のamountは正数です。
  • 支出の更新にはgenre_idが必要です。
  • 入力検証・認証・API処理に失敗した場合はisError=trueを返します。
  • 一括処理はitemsの各要素を単体ツールと同じ引数で受け取り、順番に1回ずつ送信します。失敗した要素があっても残りを続け、要素ごとの結果を返します。isError=trueになるのは、全件が失敗した場合です。dry_run=trueではAPIを呼ばずに検証のみ行います。

対応プロトコル

MCP 2026-07-28のクライアントはserver/discoverとリクエストごとの_metaを使い、旧仕様のクライアントはinitializeで接続します。2024-10-07は対応バージョンに含まれません。

開発・検証```bash

go test ./...
go vet ./...
go build -o dist/zaim-api-mcp ./cmd/zaim-api-mcp


単体操作の14ツールの入力と期待する結果を収録した、199件のテストデータで互換性を検証します。API応答にはダミーHTTPサーバーを使います。

プロトコルテストでは実バイナリを起動し、新旧仕様での接続、stdoutとstderrの分離、EOF・SIGINT・SIGTERMによる終了を確認します。キャンセルがHTTP通信まで伝わることも検証します。

Dockerイメージにも同じstdio検証を実行できます。```bash
docker build -t zaim-api-mcp .
ZAIM_MCP_TEST_IMAGE=zaim-api-mcp go test ./internal/mcp -run TestStdioServer -count=1

テストは実Zaim APIへ接続しません。実バイナリの検証では、認証情報の環境変数を空にします。ローカルのバイナリを起動するときは、HOMEとXDG_CONFIG_HOMEも一時ディレクトリに向け、保存した認証情報を読まないようにしています。

PR作成・更新時とmainへの更新時には、GitHub Actionsでコードの整形、vet、race検査付きテスト、ビルドを確認します。Dockerでも新旧仕様での接続と終了処理を検証します。

ディレクトリ構成```text

cmd/zaim-api-mcp/ 起動・終了処理、authサブコマンドの振り分け
internal/auth/ auth loginの認可フロー
internal/config/ 環境変数・保存ファイルからの認証情報の読込、保存、伏字
internal/mcp/ MCPサーバーと契約・プロトコルテスト
internal/mcp/tools/ 18ツール、入出力スキーマ、応答変換
internal/version/ サーバーバージョン
testdata/ 互換性検証用のテストデータと既存ツール定義
```

ライセンス

MIT

関連リンク

  • Zaim API
  • MCP仕様
  • 公式Go MCP SDK

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Zaim API MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zaim API MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zaim API MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zaim API MCP Server 需要 API Key 吗?

资料标注需要混合方式认证,使用前准备好对应凭据,并按最小权限配置。

Zaim API MCP Server 能提供哪些能力?

资料显示能力标签包括 安全、开发工具、数据分析。具体工具清单以官方文档为准。

Zaim API MCP Server 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Zaim API MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。