Stock Info (AKShare)

🚀 株式情報サービスセンター

これはFastMCPに基づく株式データサービスで、過去の株価データ、会社の基本情報、ニュース情報などの機能を提供しています。

📁 プロジェクト構造

stock-info/
├── src/
│   ├── config/           # 設定管理
│   │   └── settings.py
│   ├── core/            # コア機能
│   │   └── exceptions.py
│   ├── models/          # データモデル
│   │   └── stock.py
│   ├── repository/      # データアクセス層
│   │   └── stock_repository.py
│   ├── service/         # ビジネスロジック層
│   │   └── stock_service.py
│   └── server.py        # サービスエントリー
├── pyproject.toml       # プロジェクト設定
└── README.md           # プロジェクトドキュメント

✨ 主な機能

• 株式の過去データを取得する
• 株式の基本情報を照会する
• リスク警告付き株式のリストを取得する
• 個別株式のニュースを閲覧する
• 財経ニュースを取得する（ページング対応）
• 株式の主な事業内容情報を取得する
• ..... 後続で徐々に追加予定

🛠️ MCPクライアントの設定手順

1. コードを取得する
2. uvを使用して仮想環境を作成する。Python 3.10以上のバージョンが必要です。
3. ローカルディレクトリ方式でMCPサービスを設定する

以下は設定例です：

{  
  "mcpServers": {  
     "stock-info": {  
      "isActive": true,  
      "command": "uv",  
      "args": [  
        "--directory",  
        "\\path\\to\\sock_info\\src",  
        "run",  
        "server.py"  
      ]  
    }  
  }  
}  

📋 環境要件

• Pythonバージョン：3.10以上
• 依存パッケージ：
  • fastmcp
  • akshare
  • pandas
  • pydantic
  • pydantic-settings

📦 インストールとデプロイ

1. 仮想環境を作成する

python -m venv .venv  

2. 仮想環境をアクティブ化する

• Windowsシステム：.venv\Scripts\activate
• Linux/macOSシステム：source .venv/bin/activate

3. 依存パッケージをインストールする

pip install -r requirements.txt  

🚀 サービスの起動

1. デフォルト設定で起動する

python src/server.py  

2. HTTPプロトコルで起動する

uvicorn stock_info.app:app --reload  

💻 使用例

以下はサービスが提供する主な機能とその用途です：

• 株式の過去データを取得する：get_stock_history_data() 指定した株式の過去の株価データを返します。

• 株式の基本情報を照会する：get_stock_info() 株式の基本情報（会社名、業界など）を返します。

• リスク警告付き株式のリストを取得する：get_risk_warning_stocks() 現在リスク警告がある株式のリストを取得します。

• 個別株式のニュースを閲覧する：get_stock_news() 指定した株式の関連ニュース情報を取得します。

• 財経ニュース（ページング対応）：get_financial_news() 最新の財経ニュースを返し、ページングでの検索をサポートします。

• 株式の主な事業内容情報を取得する：get_main_business_info() 株式の主な事業内容の詳細を返します。

🌟 プロジェクトの特徴

1. モジュール化設計：コード構造が明確で、保守と拡張が容易です。
2. 統一的な例外処理：exceptions.pyを通じて統一的なエラー捕捉と処理メカニズムを実現しています。
3. データアクセス層：repository層を使用してデータ操作をカプセル化し、コードの再利用性を向上させます。
4. 依存関係管理：pyproject.tomlとrequirements.txtを通じてプロジェクトの依存関係を管理し、環境の一貫性を確保します。

📝 開発規範

1. PEP 8コーディング規範に従い、コードスタイルを統一します。
2. 黑体（black）を使用してコードを整形し、コードの可読性を確保します。
3. ruffツールを使用してコードをチェックし、lintingを行い、コードの品質を保証します。
4. コードをコミットする前に、テストケースを実行し、すべてのチェックが通過することを確認してください。

❌ エラー処理

サービスがエラーに遭遇した場合、次のJSON形式のレスポンスを返します：

{  
  "error": {  
    "code": " ErrorCode ",  
    "message": " Error Message "  
  }  
}  

以下は主なエラーコードとそれに対応する意味です：

• 400: パラメータエラー（Bad Request）
• 401: 未承認のアクセス（Unauthorized）
• 403: アクセス禁止（Forbidden）
• 404: リソースが見つかりません（Not Found）
• 500: 内部サーバーエラー（Internal Server Error）

⚠️ 注意事項

1. すべてのAPIインターフェイスはJSON形式のレスポンスをサポートし、一部のインターフェイスはページング検索もサポートしています。
2. 使用する前に、インターフェイスドキュメントをよく読み、パラメータと返り値を正しく使用するようにしてください。
3. サービスの実行時には一定のオーバーヘッドが発生する場合があります。実際の状況に応じてリソース制限を設定してください。