Bond MCP Server

A lightweight, fast-deploy server for China bond market data integration, leveraging AkShare and MCP framework.

Features

📈 Integration with AkShare for financial data.
🛠️ Easy setup with uv for Python environment management.
⚡ Simple configuration to use in MCP client.

Development Setup

Prerequisites

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

Steps

Install uv package manager

brew install uv

Initialize project environment

uv init bond-mcp-server

Add project dependencies

uv add akshare "mcp[cli]"

Project Usage

1. Clone the repository

git clone [email protected]:pangahn/bond-mcp-server.git
cd bond-mcp-server

2. Sync dependencies

uv sync

This will install all required dependencies defined in the project.

3. Configure MCP Client

Add the following configuration to your MCP client config file:

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

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

4. Use in MCP Client

Once configured, simply start the MCP client. The china-bond server will automatically launch and be available for use within the client environment.

Additional Notes

To update or add new packages:

uv add <package-name>
uv sync

To remove a package:

uv remove <package-name>
uv sync

Check available uv commands:

uv --help

License

MIT License

Would you like me to include example usage of how to query data from the server in the client as well?