How do I use finance-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@finance-mcp get the stock symbol for Apple" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.