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.
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?
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?
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?
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?
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?
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.