MCP 服务器

スマレジMCPサーバー

Enables LLMs to generate code for interacting with the Smaregi platform API by providing API usage documentation, but does not call the actual API.

README

社内勉強会の発表資料用のMCPサーバ試作レポジトリです。

スマレジMCPサーバー

スマレジプラットフォームAPIの操作方法を提供するModel Context Protocol (MCP) サーバーです。

概要

このMCPサーバーは、LLM（Claude、GPT等）がスマレジAPIを使用するコードを生成できるよう、API操作方法の情報を提供します。実際のAPIを呼び出すのではなく、APIの使用方法を教えるドキュメントサーバーとして機能します。

機能

提供するリソース

取引一覧取得方法 (smaregi://api/transactions/list)
- スマレジAPIから取引一覧を取得する方法
- エンドポイント、パラメータ、サンプルコードを含む
取引作成方法 (smaregi://api/transactions/create)
- スマレジAPIで新規取引を作成する方法
- 必須フィールド、リクエスト形式、サンプルコードを含む

特徴

動的ドキュメント取得: 最新のスマレジAPIドキュメントを都度取得
MCP準拠: 標準的なMCPプロトコルに完全準拠
Docker対応: コンテナとして簡単にデプロイ可能
STDIO Transport: 標準入出力による安全な通信

必要な環境

Docker（推奨）
または Rust 1.75以上（直接実行する場合）

インストールと使用方法

Dockerを使用する場合（推奨）

MCPクライアント設定

MCPクライアント（Claude Desktop等）の設定ファイルに以下を追加：

{
  "mcpServers": {
    "smaregi": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "smaregi-mcp:latest"]
    }
  }
}

使用例

MCPクライアントで以下のように質問できます：

スマレジAPIで取引一覧を取得するコードを書いて

スマレジAPIで新しい取引を作成するPythonコードを教えて

直接実行する場合

ビルド
```
cargo build --release
```
実行
```
./target/release/smaregi-mcp
```

開発者向け情報

プロジェクト構造

.kiro/specs/: プロジェクト仕様（要件、設計、タスク）
docs/: 技術ドキュメント
src/: Rustソースコード（実装後）

開発に参加する

仕様の確認
実装の開始
- タスクリストを確認
- 順次タスクを実行
MCPについて学ぶ
- MCP概要
- MCP公式ドキュメント

MCP Inspectorによる動作確認

開発中のMCPサーバーの動作確認には、公式のMCP Inspectorを使用します。

インストール

npm install -g @modelcontextprotocol/inspector

基本的な使い方

# 開発中（デバッグビルド）
mcp-inspector cargo run

# リリースビルド
cargo build --release
mcp-inspector ./target/release/smaregi-mcp

# Docker環境
docker build -t smaregi-mcp:latest .
mcp-inspector docker run -i smaregi-mcp:latest