{"id":29194738,"url":"https://github.com/mlziade/librarian","last_synced_at":"2026-04-24T12:07:52.308Z","repository":{"id":302284350,"uuid":"1011522729","full_name":"mlziade/librarian","owner":"mlziade","description":"Librarian is a MCP Server that allows any LLM with a compatible MCP client to query for information on Wikipedia","archived":false,"fork":false,"pushed_at":"2025-07-24T04:26:47.000Z","size":530,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-24T07:51:37.265Z","etag":null,"topics":["fact-checking","mcp","mcp-server","wikipedia"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlziade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-01T00:40:56.000Z","updated_at":"2025-07-24T04:26:51.000Z","dependencies_parsed_at":"2025-07-01T14:54:59.074Z","dependency_job_id":null,"html_url":"https://github.com/mlziade/librarian","commit_stats":null,"previous_names":["mlziade/librarian"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mlziade/librarian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlziade%2Flibrarian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlziade%2Flibrarian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlziade%2Flibrarian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlziade%2Flibrarian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlziade","download_url":"https://codeload.github.com/mlziade/librarian/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlziade%2Flibrarian/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32222551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T10:26:35.452Z","status":"ssl_error","status_checked_at":"2026-04-24T10:25:27.643Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fact-checking","mcp","mcp-server","wikipedia"],"created_at":"2025-07-02T04:38:02.669Z","updated_at":"2026-04-24T12:07:52.303Z","avatar_url":"https://github.com/mlziade.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# librarian\n\nLibrarian is a MCP (Model Context Protocol) Server that allows any LLM with a compatible MCP client to query Wikipedia for information. It can be configured to automatically fact-check information without requiring explicit user requests.\n\n**Note:** While this guide focuses on Claude Desktop setup, Librarian also supports remote hosting via WebSocket/HTTP for broader accessibility.\n\n\n\u003e *\"The only thing that you absolutely have to know is the location of the library.\"*\n\u003e \n\u003e — Albert Einstein\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/Example1.png\" alt=\"Claude Desktop Response\" width=\"600\"\u003e\n\n*Example of Claude Desktop using the librarian MCP server to fact-check information*\n\n\u003c/div\u003e\n\n## Features\n\n- **Automatic Fact-Checking**: Configure Claude Desktop to proactively verify factual claims using Wikipedia\n- **Wikipedia Search**: Search for relevant Wikipedia articles\n- **Page Information**: Get detailed information about specific Wikipedia pages\n- **Page Summaries**: Quick summaries of Wikipedia pages\n- **Page Sections**: Get specific sections from Wikipedia pages\n- **Multi-language Support**: Query Wikipedia in different languages\n\n## Installation\n\n### Claude Desktop Setup\n\n#### 1. Prerequisites\n\n- [Claude Desktop](https://claude.ai/download) installed on your computer\n- [uv](https://docs.astral.sh/uv/) package manager installed\n- Python 3.13 or higher\n\n#### 2. Clone and Set Up the Project\n\n```bash\ngit clone \u003cyour-repository-url\u003e\ncd librarian\nuv sync\n```\n\n#### 3. Configure Claude Desktop\n\nAdd this configuration to your Claude Desktop configuration file:\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n**For Windows:**\n```json\n{\n    \"mcpServers\": {\n        \"librarian\": {\n            \"command\": \"C:\\\\Users\\\\[USERNAME]\\\\.local\\\\bin\\\\uv.exe\",\n            \"args\": [\"--directory\", \"C:\\\\Users\\\\[USERNAME]\\\\path\\\\to\\\\librarian\", \"run\", \"python\", \"librarian_stdio.py\"],\n            \"env\": {\n                \"PYTHONPATH\": \"C:\\\\Users\\\\[USERNAME]\\\\path\\\\to\\\\librarian\"\n            }\n        }\n    }\n}\n```\n\n**For macOS/Linux:**\n```json\n{\n    \"mcpServers\": {\n        \"librarian\": {\n            \"command\": \"uv\",\n            \"args\": [\"--directory\", \"/path/to/your/librarian\", \"run\", \"python\", \"librarian_stdio.py\"],\n            \"env\": {\n                \"PYTHONPATH\": \"/path/to/your/librarian\"\n            }\n        }\n    }\n}\n```\n\n**Important**: \n- Replace `[USERNAME]` and `/path/to/your/librarian` with your actual paths\n- The `--directory` flag ensures uv uses the correct project environment\n- Use the full path to `uv.exe` on Windows for reliability\n\n#### 4. Restart Claude Desktop\n\nAfter adding the configuration, restart Claude Desktop completely to load the MCP server.\n\n#### 5. Troubleshooting\n\nIf you encounter issues:\n\n1. **Check Claude Desktop logs**: \n   - **Windows**: `%AppData%\\Claude\\logs\\mcp-server-librarian.log`\n   - **macOS**: `~/Library/Logs/Claude/mcp-server-librarian.log`\n\n2. **Common issues**:\n   - `ModuleNotFoundError`: Ensure you're using the `--directory` flag and correct paths\n   - `File not found`: Use absolute paths for both `command` and in `args`\n   - `Virtual environment warnings`: These are harmless but can be avoided with proper paths\n\n3. **Test manually**:\n   ```bash\n   cd /path/to/librarian\n   uv run python librarian_stdio.py\n   # Should start without errors\n   ```\n\n\n## Automatic Fact-Checking Setup\n\nTo make Claude Desktop automatically use Wikipedia for fact-checking, start your conversations with:\n\n```\n\"Use your Wikipedia tools to automatically fact-check any factual claims in our conversation. Don't wait for me to ask - proactively verify information and provide corrections when needed.\"\n```\n\nOr use the built-in system prompt by referencing: `fact_checking_instructions`\n\n### Behavior Examples\n\nOnce configured, Claude Desktop will automatically:\n\n- ✅ Verify historical dates and events\n- ✅ Check biographical information  \n- ✅ Confirm scientific facts and discoveries\n- ✅ Validate geographical information\n- ✅ Correct common misconceptions\n- ✅ Provide source attribution from Wikipedia\n\n## Available Tools\n\n1. **search_wikipedia_pages**: Search for Wikipedia articles on any topic and return the top 5 results with selection information\n2. **get_wikipedia_page_info**: Get comprehensive information about a specific page including content, summary, hyperlinked words, and categories\n3. **get_wikipedia_page_summary**: Get quick summaries of Wikipedia pages with customizable sentence length\n4. **get_wikipedia_page_sections**: Get a list of all sections on a Wikipedia page for large pages where you need specific information\n5. **get_wikipedia_page_sections_info**: Get detailed content for specific sections of a Wikipedia page by title or index\n\nAll tools support multi-language Wikipedia queries by specifying the language parameter (default: \"en\").\n\n## Examples\n\n### Available Tools in Claude Desktop\n\u003cimg src=\"docs/Example2.png\" alt=\"Tools Available\" width=\"600\"\u003e\n\n*Screenshot showing the Wikipedia tools available in Claude Desktop when the MCP server is properly configured*\n\n### MCP Servers Configuration\n\u003cimg src=\"docs/Example3.png\" alt=\"MCP Servers\" width=\"600\"\u003e\n\n*Claude Desktop showing the librarian MCP server successfully connected and available*\n\n### VS Code Integration Example\n\u003cimg src=\"docs/Example4.png\" alt=\"VS Code Response\" width=\"600\"\u003e\n\n*Example of using the librarian tools within VS Code with GitHub Copilot*\n\n## License\n\nThis project is open source. Please check the license file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlziade%2Flibrarian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlziade%2Flibrarian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlziade%2Flibrarian/lists"}