mcp-and-services
Configure and troubleshoot LEANN's local MCP stdio server, Claude and OpenClaw clients, and read-only HTTP search service.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- mcp-and-services
- license
- MIT
- metadata
- { "disco-role": "operating" }
- description
- Configure and troubleshoot LEANN's local MCP stdio server, Claude and OpenClaw clients, and read-only HTTP search service.
- disable-model-invocation
- true
02 资源文件 4
- 参考文档references/client-and-openclaw-setup.md6.1 KB
- 参考文档references/http-service.md5.2 KB
- 参考文档references/mcp-protocol-and-tools.md6.9 KB
- 参考文档references/troubleshooting.md9.4 KB
03 SKILL.md 正文
LEANN MCP and Services
Use this sub-skill when the task is about leann_mcp, MCP JSON-RPC tools,
Claude Code/Desktop, OpenClaw integration, or leann serve.
Route the task
- For MCP lifecycle, exact tool schemas, result/error envelopes, and direct protocol probes, read MCP protocol and tools.
- For Claude or OpenClaw registration, project working directories, and the
separate
leann-memoryidentity, read client and OpenClaw setup. - For HTTP endpoints, request/response models, host/port controls, and exposure boundaries, read HTTP service.
- For startup, protocol, index, manifest, path, or network failures, use the decision table in troubleshooting.
- To generate a parseable MCP client configuration or a reviewed HTTP command
without launching anything, run
python scripts/generate_service_config.py --helpfrom this directory, or invoke that script by its path from any working directory.
Operating rules
- Treat MCP as line-delimited JSON-RPC over stdio. Reserve stdout for one JSON response per line; send diagnostics to stderr.
- Run the MCP child and HTTP service from the project root that owns
.leann/indexes/. Index names are project-relative on the build, status, and HTTP paths even thoughleann_listcan discover registered projects. - Keep the default HTTP bind at
127.0.0.1. The service has no built-in authentication or TLS; require an explicit deployment control before any non-loopback bind. - Assume tools can read indexed local files and return passage text, metadata, and paths. Minimize filesystem permissions and never expose private indexes to an untrusted client or network.
- Do not place secrets in generated MCP JSON. Embedding or language-model
credentials belong to the
embeddings-and-chatsub-skill.
Boundaries
- Slack/Twitter content acquisition and reader behavior:
rag-applications. - Search quality, filters, and index lifecycle semantics:
api-and-indexing. - General CLI build/watch/daemon operations:
cli-operations. - Embedding/LLM provider setup and credentials:
embeddings-and-chat.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.