Finance MCP Server logo

Finance MCP Server

by esurovtsev

A minimal MCP server built with Python that exposes tools to convert company names to stock symbols and fetch financial data from Yahoo Finance. It serves as a demo project for learning how to build and run an MCP server.

View on GitHub

Last updated: N/A

What is Finance MCP Server?

This is a minimal MCP server written in Python that provides two example tools: one to convert a company name into a stock symbol, and another to fetch financial data from Yahoo Finance. It's designed as a learning tool for building and running MCP servers.

How to use Finance MCP Server?

The server can be installed in development or production mode using uv pip. It can be run directly using the finance-mcp command. For use with MCP clients like Claude Desktop, configure the client to execute the server using the provided command and arguments, ensuring the correct path to the server's directory is specified.

Key features of Finance MCP Server

  • Converts company names to stock symbols

  • Fetches financial data from Yahoo Finance

  • Simple example for learning MCP server development

  • Easy installation via uv pip

  • Configurable for use with MCP clients

Use cases of Finance MCP Server

  • Learning MCP server development

  • Integrating financial data into AI applications

  • Demonstrating custom tool integration with AI models

  • Building custom financial tools for AI assistants

FAQ from Finance MCP Server

What is an MCP server?

MCP stands for Model Control Protocol. It's a protocol that allows AI models to discover and interact with custom tools.

What data does this server provide?

This server provides stock symbols based on company names and financial data from Yahoo Finance.

How do I install this server?

You can install it in development mode by cloning the repository and using uv pip install -e . or in production mode using uv pip install finance-mcp.

How do I configure this server with Claude Desktop?

You need to add a configuration entry to your claude_desktop_config.json file, specifying the command and arguments to run the server.

Where can I learn more about building MCP servers?

The provided video walkthrough offers a practical guide to building MCP servers with Python SDK and Cursor IDE.