MCP Documentation Server
This project serves documentation for various applications using the Model Context Protocol (MCP). It demonstrates how to organize and expose documentation content, including quickstart guides and code examples, via MCP tools.
📚 Documentation Structure
Application documentation is organized under the content/ directory. For the XYZ application, content is located in content/xyz/ and includes:
quickstart.md: A quickstart guide for integrating with the XYZ application.code_examples.md: Various code examples demonstrating how to use the XYZ application with MCP tools.
🛠️ MCP Tools
MCP tools are defined in app/mcp/mcp_routes.py to expose the documentation content:
quickstart: Provides the quickstart guide for a specified application.code_examples: Provides code examples for a specified application.
⚙️ Setup Instructions
-
Initialize the environment
uv init uv venv source .venv/bin/activate uv pip install fastapi uvicorn openai fastmcp uvicorn app.main:app -
Start the application server
Run the provided start script:
chmod +x scripts/start.sh ./scripts/start.sh
Connect to MCP Server using Claude Desktop
To connect Claude Desktop to this MCP documentation server, you need to add a new server configuration in Claude's settings.
- Open Claude Desktop settings.
- Navigate to the 'Developer' section.
- Under 'MCP Server Configs', add the following JSON configuration:
{
"AppDocsServer": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8000/mcp-app-docs-server/mcp"
]
}
}
- Save the settings. Claude Desktop should now be able to discover and use the tools provided by this server.
Running the MCP Inspector
To test and inspect the MCP tools exposed by this server, you can use the MCP inspector tool. Run the following command in your terminal:
npx @modelcontextprotocol/inspector node build/index.js
This will start the inspector, allowing you to interact with the quickstart and code_examples tools provided by this server.