Bond MCP Server

🚀 債券 MCP 服務器

債券 MCP 服務器是一個輕量級且可快速部署的服務器，專門用於集成中國債券市場數據。它藉助 AkShare 和 MCP 框架，為用戶提供高效的數據集成服務。

🚀 快速開始

本服務器的使用並不複雜，按照以下步驟操作，即可快速開啟數據集成之旅。

開發環境搭建

先決條件

• 操作系統：macOS / Linux 系統（或帶有 WSL 的 Windows）
• macOS 用戶需已安裝 Homebrew

搭建步驟

1. 安裝 uv 包管理器

brew install uv

2. 初始化項目環境

uv init bond-mcp-server

3. 添加項目依賴項

uv add akshare "mcp[cli]"

項目使用說明

1. 克隆倉庫

git clone git@github.com:pangahn/bond-mcp-server.git
cd bond-mcp-server

2. 同步依賴項

uv sync

此操作將安裝項目中定義的所有必需依賴項。

3. 配置 MCP 客戶端

在你的 MCP 客戶端配置文件中添加以下內容：

{
  "mcpServers": {
    "china-bond": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/bond-mcp-server",
        "run",
        "server.py"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

⚠️ 重要提示

請將 /path/to/bond-mcp-server 替換為實際克隆項目的路徑。

4. 在 MCP 客戶端中使用

配置完成後，只需啟動 MCP 客戶端。china-bond 服務器將自動啟動並可供客戶端環境使用。

✨ 主要特性

• 📈 集成 AkShare 進行金融數據分析，為用戶提供強大的數據分析能力。
• 🛠️ 使用 uv 簡化 Python 環境管理，讓環境管理變得輕鬆簡單。
• ⚡ 簡單配置即可在 MCP 客戶端中使用，降低了使用門檻。

📦 安裝指南

開發環境搭建

先決條件

• 操作系統：macOS / Linux 系統（或帶有 WSL 的 Windows）
• macOS 用戶需已安裝 Homebrew

搭建步驟

1. 安裝 uv 包管理器

brew install uv

2. 初始化項目環境

uv init bond-mcp-server

3. 添加項目依賴項

uv add akshare "mcp[cli]"

項目使用說明

1. 克隆倉庫

git clone git@github.com:pangahn/bond-mcp-server.git
cd bond-mcp-server

2. 同步依賴項

uv sync

此操作將安裝項目中定義的所有必需依賴項。

3. 配置 MCP 客戶端

在你的 MCP 客戶端配置文件中添加以下內容：

{
  "mcpServers": {
    "china-bond": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/bond-mcp-server",
        "run",
        "server.py"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

⚠️ 重要提示

請將 /path/to/bond-mcp-server 替換為實際克隆項目的路徑。

4. 在 MCP 客戶端中使用

配置完成後，只需啟動 MCP 客戶端。china-bond 服務器將自動啟動並可供客戶端環境使用。

💻 使用示例

補充說明

• 更新或添加新包

uv add <package-name>
uv sync

• 移除一個包

uv remove <package-name>
uv sync

• 查看可用的 uv 命令

uv --help

📄 許可證

本項目採用 MIT 許可證。