Stack Overflow MCP Light
A server that exposes a set of tools for interacting with Stack Overflow API. It provides functionality for searching questions, answers, tags, and retrieving detailed information from Stack Overflow.
Installation
npx stack-overflow-mcp-lightAsk AI about Stack Overflow MCP Light
Powered by Claude Β· Grounded in docs
I know everything about Stack Overflow MCP Light. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Stack Overflow MCP Server
A Model Context Protocol (MCP) server that provides comprehensive tools for interacting with Stack Overflow through the Stack Exchange API. This server enables AI assistants to search questions, get detailed answers, and explore Stack Overflow content through a standardized interface.
π Features
- Question Search - Advanced search with multiple filters and sorting options
- Question Details - Get comprehensive information including answers with body content
- Tag-based Search - Find questions by specific tags
- Top Answers - Retrieve highly-voted answers from the community
- Type Safety - Full Pydantic validation with structured response models
- Error Handling - Comprehensive error reporting and graceful failure modes
π¦ Installation
Using uvx (Recommended)
uvx stack-overflow-mcp-light
Using uv
uv add stack-overflow-mcp-light
uv run stack-overflow-mcp-light
Using pip
pip install stack-overflow-mcp-light
stack-overflow-mcp-light
βοΈ Configuration
Environment Variables
STACK_EXCHANGE_API_KEY(Optional): Stack Exchange API key for increased rate limits. Get one at Stack AppsSTACK_OVERFLOW_MCP_SHOW_LOGS(Optional): Set to"true"to enable detailed logging
π‘ API Key: While optional, an API key significantly increases your rate limits from 300 to 10,000 requests per day.
Transport Types
stdio(default) - Standard input/output, client launches server automaticallyhttp(recommended for remote) - Modern HTTP transport (aliases:streamable-http,streamable_http)sse(legacy) - Server-Sent Events transport (deprecated)
π Quick Start (uvx)
Stdio Transport
{
"mcpServers": {
"stack-overflow": {
"command": "uvx",
"args": ["--no-progress", "stack-overflow-mcp-light"],
"env": {
"STACK_EXCHANGE_API_KEY": "your_api_key_here",
"STACK_OVERFLOW_MCP_SHOW_LOGS": "false"
}
}
}
}
HTTP Transport
Start server:
export STACK_EXCHANGE_API_KEY="your_api_key_here"
uvx --no-progress stack-overflow-mcp-light --transport http --port 8000 --host 0.0.0.0
Client config:
{
"mcpServers": {
"stack-overflow": {
"url": "http://localhost:8000/mcp",
"transport": "http"
}
}
}
SSE Transport
Start server:
export STACK_EXCHANGE_API_KEY="your_api_key_here"
uvx --no-progress stack-overflow-mcp-light --transport sse --port 8000 --host 0.0.0.0
Client config:
{
"mcpServers": {
"stack-overflow": {
"url": "http://localhost:8000/sse",
"transport": "sse"
}
}
}
π§ Alternative Commands
Stdio with uv run --with
{
"mcpServers": {
"stack-overflow": {
"command": "uv",
"args": ["run", "--with", "stack-overflow-mcp-light", "stack-overflow-mcp-light"],
"env": {
"STACK_EXCHANGE_API_KEY": "your_api_key_here",
"STACK_OVERFLOW_MCP_SHOW_LOGS": "false"
}
}
}
}
Stdio with uv run --directory (Local Development)
{
"mcpServers": {
"stack-overflow": {
"command": "uv",
"args": ["run", "--directory", "/path/to/stack-overflow-mcp-light", "stack-overflow-mcp-light"],
"env": {
"STACK_EXCHANGE_API_KEY": "your_api_key_here",
"STACK_OVERFLOW_MCP_SHOW_LOGS": "true"
}
}
}
}
Stdio with pip Install
{
"mcpServers": {
"stack-overflow": {
"command": "stack-overflow-mcp-light",
"args": [],
"env": {
"STACK_EXCHANGE_API_KEY": "your_api_key_here",
"STACK_OVERFLOW_MCP_SHOW_LOGS": "false"
}
}
}
}
HTTP/SSE Alternative Commands
All transport types can use these alternative commands:
# Using uv run --with
export STACK_EXCHANGE_API_KEY="your_api_key_here"
uv run --with stack-overflow-mcp-light stack-overflow-mcp-light --transport http --port 8000
# Using uv run --directory (local development)
export STACK_EXCHANGE_API_KEY="your_api_key_here"
cd /path/to/stack-overflow-mcp-light
uv run stack-overflow-mcp-light --transport http --port 8000
# Using pip install
export STACK_EXCHANGE_API_KEY="your_api_key_here"
stack-overflow-mcp-light --transport http --port 8000
π οΈ Available Tools
β Question Tools (3 tools)
search_questions
Search Stack Overflow questions with advanced filters.
- Input: Search parameters including:
q- Free-form text searchtagged- Semi-colon delimited list of tagsintitle- Search in question titlesnottagged- Exclude these tagsbody- Text in question bodyaccepted- Has accepted answer (boolean)closed- Question is closed (boolean)answers- Minimum number of answersviews- Minimum view countsort- Sort criteria ("activity", "votes", "creation", "hot", "week", "month", "relevance")order- Sort order ("asc" or "desc")page- Page number (1-25)page_size- Items per page (1-100)
- Output: Array of question items with essential fields:
question_id- Question IDis_answered- Whether the question has answersscore- Question scorelink- Link to the questiontitle- Question title
fetch_question_answers
Fetch a specific question, always including answers with body content sorted by the specified criteria.
- Input: Question details request including:
question_id- Question ID (required)sort- Answer sort criteria ("activity", "votes", "creation") - defaults to "votes"order- Sort order ("asc" or "desc") - defaults to "desc"page_size- Maximum number of answers to return (1-100) - defaults to 30
- Output: QuestionItem with detailed information including:
question_id- Question IDis_answered- Whether the question has answersscore- Question scorelink- Link to the questiontitle- Question titleanswers- Array of AnswerItem objects with:answer_id- Answer IDis_accepted- Whether the answer is acceptedscore- Answer scorebody- Answer body content
search_questions_by_tag
Search questions that have a specific tag.
- Input:
tag(tag name),sort,order,page,page_size - Output: Array of question items with essential fields:
question_id- Question IDis_answered- Whether the question has answersscore- Question scorelink- Link to the questiontitle- Question title
π§ͺ Testing
The project includes comprehensive tests covering all tools:
# Run all tests
make test
# Run with coverage
make test-cov
# Run specific test categories
uv run pytest tests/test_server.py::TestQuestionTools -v
π§ Development
Setup Development Environment
# Clone the repository
git clone https://github.com/midodimori/stack-overflow-mcp-light.git
cd stack-overflow-mcp-light
# Install with development dependencies
make install-dev
# Run tests
make test
# Format and lint code
make format
# Check code style and types
make lint
# Run the server locally
make run
# See all available commands
make help
Project Structure
stack-overflow-mcp-light/
βββ src/stack_overflow_mcp_light/
β βββ __init__.py
β βββ server.py # MCP server implementation
β βββ logging_config.py # Logging configuration
β βββ models/ # Pydantic models
β β βββ __init__.py
β β βββ requests.py # Request models
β β βββ responses.py # Response models
β βββ tools/ # Tool implementations
β βββ __init__.py
β βββ base_client.py # Base client for Stack Exchange API
β βββ questions.py # Question search and retrieval tools
βββ tests/
β βββ test_server.py # Tool function tests
β βββ test_mcp_integration.py # MCP integration tests
βββ pyproject.toml # Project configuration
βββ README.md
π API Reference
Question Sort Options
- activity: Sort by last activity date (default)
- votes: Sort by question score
- creation: Sort by creation date
- hot: Sort by current hotness
- week: Sort by weekly activity
- month: Sort by monthly activity
- relevance: Sort by search relevance
Answer Sort Options
- activity: Sort by last activity date (default)
- votes: Sort by answer score
- creation: Sort by creation date
Sort Order
- desc: Descending order (default)
- asc: Ascending order
π€ Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
β οΈ Disclaimer
This software is provided for educational and informational purposes only. This tool interacts with Stack Overflow's public API and respects their rate limits and terms of service. The authors are not responsible for any misuse of the Stack Exchange API or violation of their terms of service.
π Links
- Stack Overflow
- Stack Exchange API Documentation
- Stack Apps - API Key Registration
- Model Context Protocol
- FastMCP Framework
- Claude Desktop
π Support
For questions, issues, or contributions:
- Open an issue on GitHub
- Check the Stack Overflow Meta for API-related questions
- Review the comprehensive test suite for usage examples
