Dewey
Agentic search over your Dewey document collections from any MCP-compatible client.
ماذا يمكنك أن تفعل مع Dewey؟
dewey_list_collections— discover available collections and understand their purposedewey_scan_sections— quickly explore document structure to identify relevant sectionsdewey_get_section— load full content of a specific sectiondewey_search— retrieve the most relevant chunks for a focused questiondewey_research— run a full agentic research query for questions that need multi-step reasoningdewey_get_collection_stats— assess how much content has been processeddewey_list_claims— surface the most important facts across documentsdewey_list_contradictions— identify where documents disagree
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http dewey 'https://mcp.meetdewey.com/mcp'{
"mcpServers": {
"dewey": {
"type": "http",
"url": "https://mcp.meetdewey.com/mcp"
}
}
}@meetdewey/mcpclaude mcp add dewey -e 'DEWEY_API_KEY=<your dewey_api_key>' -e 'DEWEY_COLLECTION_ID=<DEWEY_COLLECTION_ID>' -e 'DEWEY_API_URL=<DEWEY_API_URL>' -- npx -y @meetdewey/mcp@1.5.4{
"mcpServers": {
"dewey": {
"command": "npx",
"args": [
"-y",
"@meetdewey/mcp@1.5.4"
],
"env": {
"DEWEY_API_KEY": "<your dewey_api_key>",
"DEWEY_COLLECTION_ID": "<DEWEY_COLLECTION_ID>",
"DEWEY_API_URL": "<DEWEY_API_URL>"
}
}
}
}متغيرات البيئة
DEWEY_API_KEYإلزامي سري Your Dewey project API keyDEWEY_COLLECTION_IDDefault collection ID. When set, tools that accept collection_id fall back to this value.DEWEY_API_URLOverride the API base URL (default: https://api.meetdewey.com/v1)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
@meetdewey/mcp
MCP server for Dewey — search and research your document collections from Claude, Cursor, and any MCP-compatible agent. See the full API reference for details.
Installation
Add to your claude_desktop_config.json (or equivalent MCP client config):
{
"mcpServers": {
"dewey": {
"command": "/bin/sh",
"args": ["-lc", "npx -y @meetdewey/mcp"],
"env": {
"DEWEY_API_KEY": "dwy_live_...",
"DEWEY_COLLECTION_ID": "..."
}
}
}
}Note for Windows users: replace
"command": "/bin/sh"and"args": ["-lc", "npx -y @meetdewey/mcp"]with"command": "npx"and"args": ["-y", "@meetdewey/mcp"]— the login-shell wrapper is only needed on macOS/Linux to pick up Homebrew and nvm PATH entries that Claude Desktop doesn't inherit.
Environment variables
| Variable | Required | Description |
|---|---|---|
DEWEY_API_KEY | Yes | Your Dewey project API key |
DEWEY_COLLECTION_ID | No | Default collection ID. When set, tools that accept collection_id will fall back to this value. |
DEWEY_API_URL | No | Override the API base URL (default: https://api.meetdewey.com/v1) |
Available tools
Search & research
| Tool | Description |
|---|---|
dewey_list_collections | List all collections in the project, including description and research instructions when set |
dewey_search | Hybrid semantic + keyword search over chunk content |
dewey_scan_sections | Lightweight search over section titles and summaries |
dewey_research | Agentic research query with configurable depth — returns a grounded, cited answer |
dewey_get_section | Fetch the full Markdown content of a section by ID |
Document management
| Tool | Description |
|---|---|
dewey_list_documents | List documents in a collection with their processing status |
dewey_get_document_sections | List all sections in a document (table of contents with heading levels and IDs) |
dewey_get_document_markdown | Fetch the full converted Markdown content of a document |
dewey_retry_document | Retry a failed document — clears error state and re-queues processing |
dewey_delete_document | Permanently delete a document and all its derived data |
Claims & contradictions
| Tool | Description |
|---|---|
dewey_list_claims | List extracted factual claims from a collection or specific document, filterable by importance (1–5) |
dewey_list_contradictions | List detected contradictions — clusters of conflicting claims with explanations and suggested resolutions |
dewey_detect_contradictions | Trigger an async contradiction detection run across all claims in a collection |
dewey_get_contradiction_run | Get the status and stats of the latest contradiction detection run (use to poll after dewey_detect_contradictions) |
dewey_resolve_contradiction | Apply a resolution instruction to a contradiction or dismiss it |
Deduplication
| Tool | Description |
|---|---|
dewey_detect_duplicates | Trigger an async deduplication run — identifies near-duplicate documents by measuring shared content across chunks and marks one per cluster as canonical |
dewey_get_duplicate_run | Get the status and stats of the latest deduplication run (use to poll after dewey_detect_duplicates) |
dewey_list_duplicate_groups | List near-duplicate groups with canonical + members and coverage percentages |
dewey_promote_duplicate_canonical | Promote a different member to canonical; old canonical becomes near_duplicate |
dewey_disband_duplicate_group | Disband a group; former members rejoin retrieval as distinct documents |
Non-canonical documents are excluded from retrieval and contradiction detection. Requires enableDeduplication: true on the collection (set via dewey_update_collection or the Dewey dashboard).
Collection settings
| Tool | Description |
|---|---|
dewey_get_collection_stats | Get document count, storage, section/chunk/claim counts, and processing status breakdown |
dewey_update_collection | Update collection name, description, research instructions, visibility, and feature flags |
dewey_recompute_summaries | Re-run AI section summarization across all documents (e.g. after changing the LLM model) |
dewey_recompute_captions | Re-run AI captioning for all images and tables across all documents |
dewey_delete_collection | Permanently delete a collection and all its data |
Research instructions
Collections can have natural-language instructions that are automatically injected into the research system prompt — for example, noting units, preferred sources, or how to handle missing information. They can be set in the Dewey dashboard, via the API, or directly through dewey_update_collection. When dewey_resolve_contradiction is used to apply a resolution, the suggested instruction is also appended here automatically.
Tool usage pattern
A typical read-only research workflow:
dewey_list_collections— discover available collections and understand their purposedewey_scan_sections— quickly explore document structure to identify relevant sectionsdewey_get_section— load full content of a specific sectiondewey_search— retrieve the most relevant chunks for a focused questiondewey_research— run a full agentic research query for questions that need multi-step reasoning
For deeper analysis and curation:
dewey_get_collection_stats— assess how much content has been processeddewey_list_claims— surface the most important facts across documentsdewey_list_contradictions— identify where documents disagreedewey_resolve_contradiction— apply or dismiss each contradiction, updating collection instructions automatically
License
MIT
الأسئلة الشائعة
ما هو Dewey؟
Agentic search over your Dewey document collections from any MCP-compatible client.
كيف أثبّت Dewey؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http dewey 'https://mcp.meetdewey.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Dewey إلى مفتاح API؟
نعم. يتطلب DEWEY_API_KEY، وتضبطها في إعداداته.
هل Dewey مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Dewey؟
ينشره meetdewey. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.