Audit Findings MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Audit Findings MCP Server Show me all open high severity findings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Audit Findings MCP Server
監査指摘(audit findings)を管理する SQLite データベースを、MCP(Model Context Protocol)経由で Claude から操作できるようにするサーバーです。
自然言語で「未対応の重要な指摘を見せて」と尋ねるだけで、SQL を書かずにデータベースを検索できます。
動作要件
Python 3.12 以上
uv(パッケージ管理)
SQLite3(macOS / Linux には標準で付属)
Related MCP server: Karenina MCP
インストール
git clone <このリポジトリのURL>
cd week5-mcp-sqlite
uv sync初期セットアップ
サンプルデータベースを作成します。
sqlite3 sample.db << 'SQL'
CREATE TABLE audit_findings (
id INTEGER PRIMARY KEY,
finding_date TEXT,
severity TEXT,
category TEXT,
description TEXT,
status TEXT
);
INSERT INTO audit_findings VALUES
(1, '2025-03-15', 'High', 'Access Control', 'Privileged access not reviewed', 'Open'),
(2, '2025-04-20', 'Medium', 'Change Management', 'Insufficient testing documentation', 'Closed'),
(3, '2025-05-10', 'High', 'Data Protection', 'Encryption keys rotation overdue', 'Open');
SQL使い方
動作確認(MCP Inspector)
npx @modelcontextprotocol/inspector uv run python server.pyブラウザが開いたら Connect を押し、Tools / Resources / Prompts の各タブから動作を確認できます。
Claude Code から利用する
claude mcp add audit-findings -- uv run python server.py
claude mcp list
claudeClaude Code 起動後、自然言語で問い合わせます。 監査指摘のうち、未対応(Open)のものを見せて 注意: local スコープで登録した場合、サーバーはこのプロジェクトフォルダに紐づきます。必ず week5-mcp-sqlite フォルダ内で claude を起動してください。
提供機能
Tools
名前 | 種別 | 説明 |
list_findings | 読み取り | 監査指摘を全件取得する |
find_by_status | 読み取り | 指定した状態(Open / Closed)の指摘を取得する |
update_finding_status | 書き込み | 指摘のステータスを更新する |
Resources
URI | 説明 |
audit://findings/all | 監査指摘の全件データ(JSON形式、読み取り専用) |
Prompts
名前 | 説明 |
summarize_open_findings | 未対応指摘を集計・要約するための手順テンプレート |
セキュリティ上の注意
書き込みツールについて
update_finding_status はデータベースを変更するツールです。監査指摘のステータスは統制上の証跡にあたるため、意図しない更新は監査証跡の完全性を損ないます。以下の多層防御を実装しています。
入力値のホワイトリスト検証 — new_status は Open / Closed のみ許可。それ以外はデータベースに到達する前に拒否します。
更新前の存在確認 — 対象 ID が存在しない場合、明示的にエラーを返します(SQL の UPDATE は 0 件更新でもエラーにならないため)。
Tool description による警告 — 実行前にユーザーの確認を取るよう、docstring に明記しています。
変更前後の記録 — 応答に変更前後のステータスを含め、何が起きたかを追跡可能にしています。
実行時の許可要求 — Claude Code は書き込みツールの実行前にユーザーへ確認を求めます。
SQL インジェクション対策
すべての SQL はプレースホルダ(?)を使用し、値を SQL 文から分離しています。文字列連結による SQL 組み立ては行っていません。
本番利用にあたって
本リポジトリは学習用のサンプル実装です。実運用に用いる場合は、少なくとも以下の検討が必要です。
認証・認可(誰がどの指摘を更新できるか)
変更履歴の永続的な記録(監査ログテーブル)
読み取り専用モードの提供(参照用途では Resources のみ公開する)
データベースのバックアップとリストア手順
ファイル構成
ライセンス
学習目的のサンプル実装です。
Available Tools
3 toolsfind_by_statusA
指定した状態(Open / Closed)の監査指摘を取得する
Inputs: status (required).
list_findingsA
監査指摘を全件取得する
Inputs: no named parameters.
update_finding_statusA
監査指摘のステータスを更新する。
【重要】これはデータベースを変更する書き込み操作です。
実行前に必ずユーザーに確認を取ってください。
どの指摘を、どのステータスに変更するかを明示し、
ユーザーの明確な同意を得てから実行すること。
Args:
finding_id: 更新対象の指摘ID
new_status: 新しいステータス("Open" または "Closed" のみ)
Returns:
成功時: 更新後の指摘情報
失敗時: error キーを含む辞書
Inputs: finding_id (required), new_status (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: listing all findings, filtering by status, and updating a status. There is no overlap or ambiguity between them.
All tools use snake_case and follow a verb-based pattern (list, find, update). The minor inconsistency is the use of 'find' vs 'list' for read operations, but the names are still predictable and readable.
With 3 tools, the count is within the typical well-scoped range, but it is on the lower end. Each tool serves a functional purpose, though the scope feels minimal for an audit findings domain.
The server lacks fundamental operations like creating or deleting audit findings. It only supports reading (all or by status) and updating status, leaving obvious lifecycle gaps that would force agents to work around.
Maintenance
Related MCP Connectors
Query, explore, and manage your databases through natural conversation.
Query and audit AppSheet apps in natural language via Knotrik's pre-scanned definitions.
Ask questions in plain language, get answers from your business database. No SQL required.
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with SQLite databases through natural language, supporting SQL queries, CSV imports, and schema exploration.-
- FlicenseNot gradedqualityDmaintenanceEnables natural language querying of Karenina benchmark verification results stored in SQLite databases, allowing AI assistants to explore and analyze model performance data without writing SQL manually.-
- AlicenseNot gradedqualityDmaintenanceEnables SQLite database interactions including querying, updating, and schema management through structured tools.16 PyPI3MIT
- FlicenseAqualityDmaintenanceAutomatically scans SQLite databases and generates typed CRUD tools for each table, allowing natural language database interaction without exposing raw SQL.12-