MCP Status Invest

🚀 狀態投資 - MCP 服務器

該項目是模型上下文協議（MCP）生態系統的一部分，提供了與外部 API 和特定領域模型交互的工具。它展示瞭如何構建一個集成外部 API 並具備數據驗證功能的 MCP 服務器。

🚀 快速開始

本項目為 MCP 生態系統帶來了與狀態投資 API 集成的能力，可用於查詢股票市場數據，如股票價格、指標和支付日期等。

✨ 主要特性

• 多樣化的數據獲取：
  • get-acoes：獲取基本股票信息。
  • get-indicadores：獲取詳細股票指標信息。
  • get-acoes-datas-pagamento：獲取股票支付日期。
• 輸入驗證：使用 Zod 進行輸入驗證，確保數據的準確性。
• API 集成：使用 fetch 集成狀態投資 API（基礎設施層）。

🔧 技術細節

架構

該項目遵循分層架構，靈感源自領域驅動設計（DDD）模式：

• 領域 (src/domain)：定義表示數據結構的接口和類型（例如，StatusInvest）。
• 基礎設施 (src/infrastructure)：實現外部服務，如 StatusInvestApiService，負責向狀態投資 API 發出 HTTP 請求。
• 應用層 (src/application)：包含業務邏輯，在 StatusInvestService 中處理和格式化來自基礎設施的數據。
• 接口 (src/interface)：包括控制器（StatusInvestToolsController），用於在 MCP 服務器中註冊工具，定義驗證模式並返回結果。
• 入口點 (src/main.ts)：初始化 McpServer，配置傳輸（StdioServerTransport），實例化服務和控制器，並開始偵聽標準輸入輸出。

文件結構

src/
├── domain/
│   └── models/           # 領域接口
├── infrastructure/
│   └── services/         # 外部 API 實現（狀態投資）
├── application/
│   └── services/         # 業務邏輯和數據格式化
├── interface/
│   └── controllers/      # MCP 工具註冊和驗證
└── main.ts               # 服務器入口點
build/                    # 編譯後的 JavaScript 代碼
.vscode/                  # 包含 mcp.json 文件，MCP 服務器配置

📦 安裝指南

git clone git@github.com:newerton/mcp-status-invest.git
cd mcp-status-invest
npm install
npm run build

📚 詳細文檔

VSCode 中的 MCP 服務器配置

1. 打開終端並運行以下命令：

   npm install -g npm
   

2. 在 VSCode 中，打開“終端”並執行以下命令：

   npm install -D @types/node typescript jsconfig.json
   

VSCode 中的 MCP 服務器輸出

// 配置語言模式為 JavaScript 或 TypeScript

🤝 貢獻

歡迎 fork 和 pull request！請在提交之前閱讀貢獻指南。

📄 許可證

該項目受 MIT License 保護。