sengokusal2025/f1_20250918

FGDB Code Repository

概要

このリポジトリは、Function Block（FB）の開発とテストを行うためのコードベースです。現在実装されているFunction Blockには以下があります：

• f0: 乱数生成とCSV保存機能
• f0_mcp: Model Context Protocol (MCP) サーバー実装
• f1: 追加的なFunction Block（開発中）

プロジェクト構成

code/
├─ f0/                          # f0 Function Block
│  └─ codex/
│     ├─ f0/                    # メインの乱数生成機能
│     └─ f0_mcp/                # MCP サーバー実装
├─ f1/                          # f1 Function Block（開発中）
├─ trial001/                    # 実験・試行用フォルダ
├─ of20250918/                  # 出力フォルダ（自動生成）
└─ f0_output_folder20250919/    # 出力フォルダ（自動生成）

Function Block f0

機能

• 指定個数の乱数（0-1000）を生成
• CSV形式での縦持ちデータ保存
• 抽象関数表現の出力（y=f0()）
• データの読み込みと表示

実行方法

デフォルト実行（乱数5個生成）

python -m f0.func -o output_folder

生成数指定

python -m f0.func -o output_folder -n 10

テスト実行

python -m f0.main

出力ファイル

• {output_folder}/data.csv: 生成された乱数データ
• f0/func.txt: 抽象関数表現

MCP サーバー (f0_mcp)

Model Context Protocol対応のサーバー実装が含まれています。

テスト実行

cd f0/codex/f0_mcp
python -m pytest tests/

開発ガイドライン

技術スタック

• Python 3.x（標準ライブラリのみ使用）
• CSV形式でのデータ保存
• コマンドライン引数による設定

コーディング規約

• コードは英語で記述
• ドキュメント・コメントは日本語
• Python標準ライブラリのみ使用（外部依存なし）

ファイル命名規則

• func.py: コマンドラインインターフェース
• lib.py: 主要機能の実装
• main.py: テスト・デモ用スクリプト
• specification.md: 機能仕様書
• requirements.txt: 依存関係（通常は空）

テスト

各Function Blockには対応するテストファイルが含まれています：

• 基本機能テスト: main.py
• 単体テスト: tests/ フォルダ（MCPサーバーなど）

出力フォルダ

実行時に以下のような出力フォルダが自動生成されます：

• of{YYYYMMDD}: 日付付き出力フォルダ
• f0_output_folder{YYYYMMDD}: Function Block別出力フォルダ

注意事項

• 出力フォルダは実行前に存在している必要があります
• 既存のデータファイルは上書きされます
• Python標準ライブラリのみを使用するため、外部パッケージのインストールは不要です