Bond MCP Server

🚀 Bond MCP Server

A lightweight and quickly deployable data integration server for the Chinese bond market, leveraging AkShare and the MCP framework.

✨ Features

• 📈 Integrates AkShare for financial data analysis.
• 🛠️ Uses uv to simplify Python environment management.
• ⚡ Can be used in the MCP client with simple configuration.

📦 Installation

Prerequisites

• macOS / Linux system (or Windows with WSL).
• Homebrew installed (for macOS users).

Steps

1. Install the uv package manager

brew install uv

2. Initialize the project environment

uv init bond-mcp-server

3. Add project dependencies

uv add akshare "mcp[cli]"

💻 Usage Examples

1. Clone the repository

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

2. Synchronize dependencies

uv sync

This will install all the necessary dependencies defined in the project.

3. Configure the MCP client

Add the following content to your MCP client configuration file:

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

⚠️ Important Note

Replace /path/to/bond-mcp-server with the actual path where you cloned the project.

4. Use in the MCP client

After configuration, simply start the MCP client. The china-bond server will automatically start and be available in the client environment.

Additional Instructions

• Update or add new packages:

uv add <package-name>
uv sync

• Remove a package:

uv remove <package-name>
uv sync

• View available uv commands:

uv --help

📄 License

This project is under the MIT License.