stackoverflow-mcp-server
Enables searching and retrieving Stack Overflow questions, answers, and comments for programming solutions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@stackoverflow-mcp-server Search Stack Overflow for Python asyncio examples"
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.
Stack Overflow MCP Server
This Model Context Protocol (MCP) server enables AI assistants like Claude to search and access Stack Overflow content through a standardized protocol, providing seamless access to programming solutions, error handling, and technical knowledge.
The Stack Overflow MCP Server is currently in Beta. We welcome your feedback and encourage you to report any bugs by opening an issue.
Features
š Multiple Search Methods: Search by query, error message, or specific question ID
š Advanced Filtering: Filter results by tags, score, accepted answers, and more
š§© Stack Trace Analysis: Parse and find solutions for error stack traces
š Rich Formatting: Get results in Markdown or JSON format
š¬ Comments Support: Optionally include question and answer comments
ā” Rate Limiting: Built-in protection to respect Stack Exchange API quotas
Example Prompts and Use Cases
Here are some example prompts you can use with Claude when the Stack Overflow MCP server is integrated:
Tool | Example Prompt | Description |
| "Search Stack Overflow for Django pagination best practices" | Finds the most relevant questions and answers about Django pagination techniques |
| "Find Python asyncio examples with tags python and asyncio" | Searches for specific code examples filtering by multiple tags |
| "Why am I getting 'TypeError: object of type 'NoneType' has no len()' in Python?" | Finds solutions for a common Python error |
| "Get Stack Overflow question 53051465 about React hooks" | Retrieves a specific question by ID, including all answers |
| "Fix this error: ReferenceError: useState is not defined at Component in javascript" | Analyzes JavaScript error to find relevant solutions |
| "Find highly rated answers about memory leaks in C++ with at least 10 upvotes" | Uses advanced filtering to find high-quality answers |
Related MCP server: mcp-stackexchange
Prerequisites
Before using this MCP server, you need to:
Get a Stack Exchange API key (see below)
Have Python 3.10+ installed
Install uv (recommended)
Getting a Stack Exchange API Key
To use this server effectively, you'll need a Stack Exchange API key:
Fill out the form with your application details:
Name: "Stack Overflow MCP" (or your preferred name)
Description: "MCP server for accessing Stack Overflow"
OAuth Domain: "localhost" (for local usage)
Application Website: Your website or leave blank
Submit the form
Copy your API Key (shown as "Key" on the next page)
This API key is not considered a secret and may be safely embedded in client-side code or distributed binaries. It simply allows you to receive a higher request quota when making requests to the Stack Exchange API.
Installation
Installing from PyPI
# Using pip
pip install stackoverflow-mcp
# OR Using uv
uv venv
uv pip install stackoverflow-mcp
# OR using uv wihtout an venv
uv pip install stackoverflow-mcp --systemInstalling from Source
# Clone the repository
git clone https://github.com/yourusername/stackoverflow-mcp-server.git
cd stackoverflow-mcp-server
# Install with uv
uv venv
uv pip install -e .Adding to Claude Desktop
To run the Stack Overflow MCP server with Claude Desktop:
Download Claude Desktop.
Launch Claude and navigate to: Settings > Developer > Edit Config.
Update your
claude_desktop_config.jsonfile with the following configuration:
{
"mcpServers": {
"stack-overflow": {
"command": "uv",
"args": ["run", "-m", "stackoverflow_mcp"],
"env": {
"STACK_EXCHANGE_API_KEY": "your_API_key"
}
}
}
}You can also specify a custom directory:
{
"mcpServers": {
"stack-overflow": {
"command": "uv",
"args": [
"--directory",
"/path/to/stackoverflow-mcp-server",
"run",
"main.py"
],
"env": {
"STACK_EXCHANGE_API_KEY": "your_api_key_here"
}
}
}
}Configuration
Environment Variables
The server can be configured using these environment variables:
# Required
STACK_EXCHANGE_API_KEY=your_api_key_here
# Optional
MAX_REQUEST_PER_WINDOW=30 # Maximum requests per rate limit window
RATE_LIMIT_WINDOW_MS=60000 # Rate limit window in milliseconds (1 minute)
RETRY_AFTER_MS=2000 # Delay after hitting rate limitUsing a .env File
You can create a .env file in the project root:
STACK_EXCHANGE_API_KEY=your_api_key_here
MAX_REQUEST_PER_WINDOW=30
RATE_LIMIT_WINDOW_MS=60000
RETRY_AFTER_MS=2000Usage
Available Tools
The Stack Overflow MCP server provides the following tools:
1. search_by_query
Search Stack Overflow for questions matching a query.
Parameters:
- query: The search query
- tags: Optional list of tags to filter by (e.g., ["python", "pandas"])
- excluded_tags: Optional list of tags to exclude
- min_score: Minimum score threshold for questions
- has_accepted_answer: Whether questions must have an accepted answer
- include_comments: Whether to include comments in results
- response_format: Format of response ("json" or "markdown")
- limit: Maximum number of results to return2. search_by_error
Search Stack Overflow for solutions to an error message.
Parameters:
- error_message: The error message to search for
- language: Programming language (e.g., "python", "javascript")
- technologies: Related technologies (e.g., ["react", "django"])
- min_score: Minimum score threshold for questions
- include_comments: Whether to include comments in results
- response_format: Format of response ("json" or "markdown")
- limit: Maximum number of results to return3. get_question
Get a specific Stack Overflow question by ID.
Parameters:
- question_id: The Stack Overflow question ID
- include_comments: Whether to include comments in results
- response_format: Format of response ("json" or "markdown")4. analyze_stack_trace
Analyze a stack trace and find relevant solutions on Stack Overflow.
Parameters:
- stack_trace: The stack trace to analyze
- language: Programming language of the stack trace
- include_comments: Whether to include comments in results
- response_format: Format of response ("json" or "markdown")
- limit: Maximum number of results to return5. advanced_search
Advanced search for Stack Overflow questions with many filter options.
Parameters:
- query: Free-form search query
- tags: List of tags to filter by
- excluded_tags: List of tags to exclude
- min_score: Minimum score threshold
- title: Text that must appear in the title
- body: Text that must appear in the body
- answers: Minimum number of answers
- has_accepted_answer: Whether questions must have an accepted answer
- sort_by: Field to sort by (activity, creation, votes, relevance)
- include_comments: Whether to include comments in results
- response_format: Format of response ("json" or "markdown")
- limit: Maximum number of results to returnDevelopment
This section is for contributors who want to develop or extend the Stack Overflow MCP server.
Setting Up Development Environment
# Clone the repository
git clone https://github.com/yourusername/stackoverflow-mcp-server.git
cd stackoverflow-mcp-server
# Install dev dependencies
uv pip install -e ".[dev]"Running Tests
# Run all tests
pytest
# Run specific test modules
pytest tests/test_formatter.py
pytest tests/test_server.py
# Run tests with coverage report
pytest --cov=stackoverflow_mcpProject Structure
stackoverflow-mcp-server/
āāā stackoverflow_mcp/ # Main package
ā āāā __init__.py
| |āā __main__.py # Entry point
ā āāā api.py # Stack Exchange API client
ā āāā env.py # Environment configuration
ā āāā formatter.py # Response formatting utilities
ā āāā server.py # MCP server implementation
ā āāā types.py # Data classes
āāā tests/ # Test suite
ā āāā api/
ā ā āāā test_search.py # API search tests
ā āāā test_formatter.py # Formatter tests
ā āāā test_general_api_health.py # API health tests
ā āāā test_server.py # Server tests
āāā pyproject.toml # Package configuration
āāā api_query.py # testing stackexchange outside of MCP context
āāā LICENSE # License file
āāā README.md # This fileContributing
Contributions are welcome! Here's how you can contribute:
Fork the repository
Create a feature branch:
git checkout -b feature/my-featureCommit your changes:
git commit -am 'Add new feature'Push to the branch:
git push origin feature/my-featureSubmit a pull request
Please make sure to update tests as appropriate and follow the project's coding style.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
5 toolsadvanced_searchA
Advanced search for Stack Overflow questions with many filter options.
Args:
query (Optional[str]): Free-form search query
tags (Optional[List[str]]): List of tags to filter by
excluded_tags (Optional[List[str]]): List of tags to exclude
min_score (Optional[int]): Minimum score threshold
title (Optional[str]): Text that must appear in the title
body (Optional[str]): Text that must appear in the body
answers (Optional[int]): Minimum number of answers
has_accepted_answer (Optional[bool]): Whether questions must have an accepted answer
views (Optional[int]): Minimum number of views
url (Optional[str]): URL that must be contained in the post
user_id (Optional[int]): ID of the user who must own the questions
is_closed (Optional[bool]): Whether to return only closed or open questions
is_wiki (Optional[bool]): Whether to return only community wiki questions
is_migrated (Optional[bool]): Whether to return only migrated questions
has_notice (Optional[bool]): Whether to return only questions with post notices
from_date (Optional[datetime]): Earliest creation date
to_date (Optional[datetime]): Latest creation date
sort_by (Optional[str]): Field to sort by (activity, creation, votes, relevance)
include_comments (Optional[bool]): Whether to include comments in results
response_format (Optional[str]): Format of response ("json" or "markdown")
limit (Optional[int]): Maximum number of results to return
ctx (Context): The context is passed automatically by the MCP
Returns:
str: Formatted search results
Inputs: query, tags, excluded_tags, min_score, +17 more.
analyze_stack_traceA
Analyze a stack trace and find relevant solutions on Stack Overflow.
Args:
stack_trace (str): The stack trace to analyze
language (str): Programming language of the stack trace
excluded_tags (Optional[List[str]]): Optional list of tags to exclude
min_score (Optional[int]): Minimum score threshold for questions
has_accepted_answer (Optional[bool]): Whether questions must have an accepted answer
answers (Optional[int]): Minimum number of answers
include_comments (Optional[bool]): Whether to include comments in results
response_format (Optional[str]): Format of response ("json" or "markdown")
limit (Optional[int]): Maximum number of results to return
ctx (Context): The context is passed automatically by the MCP
Returns:
str: Formatted search results
Inputs: stack_trace (required), language (required), excluded_tags, min_score, +5 more.
get_questionA
Get a specific Stack Overflow question by ID.
Args:
question_id (int): The Stack Overflow question ID
include_comments (Optional[bool]): Whether to include comments in results
response_format (Optional[str]): Format of response ("json" or "markdown")
ctx (Context): The context is passed automatically by the MCP
Returns:
str: Formatted question details
Inputs: question_id (required), include_comments, response_format.
search_by_errorA
Search Stack Overflow for solutions to an error message
Args:
error_message (str): The error message to search for
language (Optional[str]): Programming language (e.g., "python", "javascript")
technologies (Optional[List[str]]): Related technologies (e.g., ["react", "django"])
excluded_tags (Optional[List[str]]): Optional list of tags to exclude
min_score (Optional[int]): Minimum score threshold for questions
has_accepted_answer (Optional[bool]): Whether questions must have an accepted answer
answers (Optional[int]): Minimum number of answers
include_comments (Optional[bool]): Whether to include comments in results
response_format (Optional[str]): Format of response ("json" or "markdown")
limit (Optional[int]): Maximum number of results to return
ctx (Context): The context is passed automatically by the MCP
Returns:
str: Formatted search results
Inputs: error_message (required), language, technologies, excluded_tags, +6 more.
search_by_queryB
Search Stack Overflow for questions matching a query.
Args:
query (str): The search query
tags (Optional[List[str]]): Optional list of tags to filter by (e.g., ["python", "pandas"])
excluded_tags (Optional[List[str]]): Optional list of tags to exclude
min_score (Optional[int]): Minimum score threshold for questions
title (Optional[str]): Text that must appear in the title
body (Optional[str]): Text that must appear in the body
has_accepted_answer (Optional[bool]): Whether questions must have an accepted answer
answers (Optional[int]): Minimum number of answers
sort_by (Optional[str]): Field to sort by (activity, creation, votes, relevance)
include_comments (Optional[bool]): Whether to include comments in results
response_format (Optional[str]): Format of response ("json" or "markdown")
limit (Optional[int]): Maximum number of results to return
ctx (Context): The context is passed automatically by the MCP
Returns:
str: Formatted search results
Inputs: query (required), tags, excluded_tags, min_score, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 5 tools
Tools have distinct purposes: advanced_search for comprehensive filtering, search_by_query for simpler queries, search_by_error for errors, analyze_stack_trace for stack traces, and get_question for specific retrieval. There is some overlap between advanced_search and search_by_query, but descriptions clearly differentiate them.
All tool names follow a consistent snake_case verb_noun pattern (e.g., advanced_search, get_question, search_by_error). No mixing of conventions, making it easy to predict naming for hypothetical additional tools.
5 tools is slightly below average but appropriate for a focused search-only server. Each tool covers a key use case (general search, error search, stack trace analysis, specific question retrieval). Could benefit from one more tool (e.g., for answers) but current count is reasonable.
Covers main search scenarios well, including advanced filtering, error messages, and stack traces. However, lacks tools for retrieving answers separately or exploring tags/users. The presence of two very similar search tools (advanced_search vs search_by_query) suggests slight redundancy rather than full coverage.
Maintenance
Related MCP Connectors
Give AI assistants access to real-time data. Search the web, compare flights, find hotels, and more.
Search your knowledge bases from any AI assistant using hybrid RAG.
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Gives AI assistants read access to your Dedox help centre and knowledge base articles.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides instant access to a searchable knowledge base of 16,000+ community-driven troubleshooting solutions for common coding problems. Includes community feedback and smart ranking to help AI assistants find the most effective solutions.-
- AlicenseNot gradedqualityCmaintenanceWraps the StackExchange API v2.3 to enable reading StackExchange data (questions, answers, etc.) without authentication. Allows AI agents to query StackExchange content through natural language or direct tool calls.286 npm1MIT
- AlicenseNot gradedqualityBmaintenanceProvides web search and content retrieval optimized for AI coding assistants, returning full conversations and structured content from StackOverflow, GitHub Issues, arXiv, and Wikipedia in a single call.405MIT
- FlicenseNot gradedqualityDmaintenanceProvides LLMs with tools to search Stack Overflow for programming solutions, helping ground responses in real-world code examples.-