mcpField
F
Finance MCP Server

Finance MCP Server

Local
github.com/esurovtsevFinance4Updated 81w ago
Repository

About Finance MCP Server

Finance MCP Server is a Python example server for learning how to build and run MCP services. Its financial demo exposes tools to map company names to stock symbols and retrieve data from Yahoo Finance.

Key features

  1. 01Convert company names to stock symbols
  2. 02Fetch financial data from Yahoo Finance
  3. 03Build an MCP server with Python

Use cases

  1. 01Practice building a Python MCP server
  2. 02Look up a company's stock symbol
  3. 03Retrieve financial data from Yahoo Finance

MCP support

The server exposes tools for converting company names to stock symbols and fetching Yahoo Finance data to MCP clients, as a development example.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Finance MCP Server

A minimal MCP server built with Python that exposes two example tools: one to convert a company name into a stock symbol, and another to fetch financial data from Yahoo Finance. The project focuses on learning how to build and run an MCP server—using a simple financial scenario purely as a demo use case.

Installation

Development Installation
# Clone the repository
git clone https://github.com/yourusername/mcp-finance-server-py.git
cd mcp-finance-server-py

# Install in development mode
uv pip install -e .
Production Installation
uv pip install finance-mcp

Usage

Running the Server Directly
finance-mcp
Configuration with Claude Desktop or other MCP clients

Add this to your MCP configuration file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "finance-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-finance-server-py", // Update this path
        "run",
        "finance-mcp"
      ]
    }
  }
}

Video Walkthrough

Build Your Own MCP Server: Practical Guide with Python SDK and Cursor IDE

Watch: Build Your Own MCP Server: Practical Guide with Python SDK and Cursor IDE

This video provides context and explanations that complement the code in this repository:

  • See the MCP server in action with a practical demonstration in Cursor IDE
  • Understand the design decisions behind the implementation
  • Learn how the different components work together
  • Get insights into how AI models discover and interact with custom tools

If you're looking to understand not just the "what" but the "why" behind this MCP implementation, the video offers a guided tour through the development process and explains the reasoning behind key architectural choices.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.