MCP Investidor10

🚀 投資者10 - MCP 服務器

本項目是模型上下文協議（MCP）生態系統的一部分，提供了與外部 API 和特定領域模型交互的工具。旨在展示如何構建一個具備外部 API 集成和數據驗證功能的 MCP 服務器。藉助 Investidor10 API，該集成能讓 MCP 工具查詢股票市場數據，如股票價格和指標。

🚀 快速開始

安裝

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

VSCode 中的 MCP 服務器配置

1. 按下 Ctrl+Shift+P 並選擇“MCP: 列出服務器”
2. 選擇“mcpinvestidor10”

VSCode 中的 MCP 服務器輸出

1. 按下 Ctrl+Shift+P 並選擇“MCP: 啟動服務器”
2. 在終端中運行命令：get-acoes

示例鏈接：https://glama.ai/mcp/servers/@newerton/mcp-investidor10

✨ 主要特性

• get-acoes：獲取基本股票信息。
• 使用 Zod 進行輸入驗證。
• 通過 fetch 集成 Investidor10 API（基礎設施層）。

🔧 技術細節

架構

該項目採用分層架構，靈感來自 領域驅動設計（DDD）模式：

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

文件夾結構如下所示：

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

🤝 貢獻

貢獻可以通過以下方式提交：

• 提交錯誤報告
• 創建功能請求
• 提交代碼修改

請 fork 該項目並按照標準的 GitHub 流程提交您的貢獻。

📄 許可證

該項目受 LICENSE 許可證保護。