AKShare MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Supports containerized deployment of the AKShare MCP server via Docker build and run commands

  • Provides repository access for installation of the AKShare MCP server via cloning from GitHub

  • Provides testing capabilities for the AKShare MCP server development

Servidor MCP de AKShare

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de análisis de datos financieros utilizando la biblioteca AKShare.

Características

  • Acceso a datos del mercado financiero chino y mundial a través de AKShare
  • Integración con Claude Desktop mediante el protocolo MCP
  • Soporte para diversas consultas y análisis de datos financieros

Instalación

Uso de uv (recomendado)

# Clone the repository git clone https://github.com/yourusername/akshare_mcp_server.git cd akshare_mcp_server # Create and activate a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies with uv uv pip install -e .

Usando pip

# Clone the repository git clone https://github.com/yourusername/akshare_mcp_server.git cd akshare_mcp_server # Create and activate a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -e .

Uso

Ejecutando el servidor

# Activate the virtual environment source venv/bin/activate # On Windows: venv\Scripts\activate # Run the server python run_server.py

Integración con Claude Desktop

  1. Agregue la siguiente configuración a su configuración de Claude Desktop:
"mcpServers": { "akshare-mcp": { "command": "uv", "args": [ "--directory", "/path/to/akshare_mcp_server", "run", "akshare-mcp" ], "env": { "AKSHARE_API_KEY": "<your_api_key_if_needed>" } } }
  1. Reiniciar Claude Desktop
  2. Seleccione el servidor AKShare MCP de las herramientas disponibles

Herramientas disponibles

El servidor AKShare MCP proporciona las siguientes herramientas:

  • Consultas de datos bursátiles
  • Consultas de datos de fondos
  • Consultas de datos de bonos
  • Consultas de datos de futuros
  • Consultas de datos de Forex
  • Consultas de datos macroeconómicos
  • Y más...

Agregar una nueva herramienta

Para agregar una nueva herramienta al servidor MCP, siga estos pasos:

  1. Agregue una nueva función API en src/mcp_server_akshare/api.py :
    async def fetch_new_data_function(param1: str, param2: str = "default") -> List[Dict[str, Any]]: """ Fetch new data type. Args: param1: Description of param1 param2: Description of param2 """ try: df = ak.akshare_function_name(param1=param1, param2=param2) return dataframe_to_dict(df) except Exception as e: logger.error(f"Error fetching new data: {e}") raise
  2. Agregue la nueva herramienta a la enumeración en src/mcp_server_akshare/server.py :
    class AKShareTools(str, Enum): # Existing tools... NEW_TOOL_NAME = "new_tool_name"
  3. Importe la nueva función en src/mcp_server_akshare/server.py :
    from .api import ( # Existing imports... fetch_new_data_function, )
  4. Agregue la definición de la herramienta a la función handle_list_tools() :
    types.Tool( name=AKShareTools.NEW_TOOL_NAME.value, description="Description of the new tool", inputSchema={ "type": "object", "properties": { "param1": {"type": "string", "description": "Description of param1"}, "param2": {"type": "string", "description": "Description of param2"}, }, "required": ["param1"], # List required parameters }, ),
  5. Agregue el controlador de herramientas en la función handle_call_tool() :
    case AKShareTools.NEW_TOOL_NAME.value: param1 = arguments.get("param1") if not param1: raise ValueError("Missing required argument: param1") param2 = arguments.get("param2", "default") result = await fetch_new_data_function( param1=param1, param2=param2, )
  6. Pruebe la nueva herramienta ejecutando el servidor y realizando una solicitud a la nueva herramienta.

Desarrollo

# Install development dependencies uv pip install -e ".[dev]" # Run tests pytest

Estibador

También puedes ejecutar el servidor usando Docker:

# Build the Docker image docker build -t akshare-mcp-server . # Run the Docker container docker run -p 8000:8000 akshare-mcp-server

Licencia

Instituto Tecnológico de Massachusetts (MIT)

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de protocolo de contexto modelo que permite a Claude Desktop acceder y analizar datos del mercado financiero chino y mundial a través de la biblioteca AKShare.

  1. Features
    1. Installation
      1. Using uv (recommended)
      2. Using pip
    2. Usage
      1. Running the server
      2. Integrating with Claude Desktop
    3. Available Tools
      1. Adding a New Tool
        1. Development
          1. Docker
            1. License
              ID: ndlloeca6d