🚀 债券 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 许可证。