fegis
Define AI tools in YAML with natural language schemas. All tool usage is automatically stored in Qdrant vector database, enabling semantic search, filtering, and memory retrieval across sessions.
Documentation
Fegis
Fegis does 3 things:
1. Easy to write tools - Write prompts in YAML format. Tool schemas use flexible natural language instructions.
2. Structured data from tool calls saved in a vector database - Every tool use is automatically stored in Qdrant with full context.
3. Search - AI can search through all previous tool usage using semantic similarity, filters, or direct lookup.
Quick Start
# Install uv
# Windows
winget install --id=astral-sh.uv -e
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone
git clone https://github.com/p-funk/fegis.git
# Start Qdrant
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 qdrant/qdrant:latestConfigure Claude Desktop
Update `claude_desktop_config.json`:
{
"mcpServers": {
"fegis": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/fegis",
"run",
"fegis"
],
"env": {
"QDRANT_URL": "http://localhost:6333",
"QDRANT_API_KEY": "",
"COLLECTION_NAME": "fegis_memory",
"EMBEDDING_MODEL": "BAAI/bge-small-en",
"ARCHETYPE_PATH": "/absolute/path/to/fegis-wip/archetypes/default.yaml",
"AGENT_ID": "claude_desktop"
}
}
}
}Restart Claude Desktop. You'll have 7 new tools available including SearchMemory.
How It Works
1. Tools from YAML
parameters:
BiasScope:
description: "Range of bias detection to apply"
examples: [confirmation, availability, anchoring, systematic, comprehensive]
IntrospectionDepth:
description: "How deeply to examine internal reasoning processes"
examples: [surface, moderate, deep, exhaustive, meta_recursive]
tools:
BiasDetector:
description: "Identify reasoning blind spots, cognitive biases, and systematic errors in AI thinking patterns through structured self-examination"
parameters:
BiasScope:
IntrospectionDepth:
frames:
identified_biases:
type: List
required: true
reasoning_patterns:
type: List
required: true
alternative_perspectives:
type: List
required: true2. Automatic Memory Storage
Every tool invocation gets stored with:
- Tool name and parameters used
- Complete input and output
- Timestamp and session context
- Vector embeddings for semantic search
3. SearchMemory Tool
"Use SearchMemory and find my analysis of privacy concerns"
"Use SearchMemory and what creative ideas did I generate last week?"
"Use SearchMemory and show me all UncertaintyNavigator results"
"Use SearchMemory and search for memories about decision-making"Available Archetypes
- `archetypes/default.yaml` - Cognitive analysis tools (UncertaintyNavigator, BiasDetector, etc.)
- `archetypes/simple_example.yaml` - Basic example tools
- `archetypes/emoji_mind.yaml` - Symbolic reasoning with emojis
- `archetypes/slime_mold.yaml` - Network optimization tools
- `archetypes/vibe_surfer.yaml` - Web exploration tools
Configuration
Required environment variables:
- `ARCHETYPE_PATH` - Path to YAML archetype file
- `QDRANT_URL` - Qdrant database URL (default: http://localhost:6333)
Optional environment variables:
- `COLLECTION_NAME` - Qdrant collection name (default: fegis_memory)
- `AGENT_ID` - Identifier for this agent (default: default-agent)
- `EMBEDDING_MODEL` - Dense embedding model (default: BAAI/bge-small-en)
- `QDRANT_API_KEY` - API key for remote Qdrant (default: empty)
Requirements
- Python 3.13+
- uv package manager
- Docker (for Qdrant)
- MCP-compatible client
License
MIT License - see LICENSE file for details.
Frequently asked questions
What is fegis?
fegis is Define AI tools in YAML with natural language schemas. All tool usage is automatically stored in Qdrant vector database, enabling semantic search, filtering, and memory retrieval across sessions.
How do I install fegis?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is fegis open source?
Yes — it is hosted on GitHub at https://github.com/p-funk/FEGIS and has 21 stars.
Related MCP tools
Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Python-based implementation. Trusted by 11000+ developers.
A middleware to provide an openAI compatible endpoint that can call MCP tools Python-based implementation. Trusted by 800+ developers.
Shell and coding agent on claude desktop app for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.
This MCP server allows Claude and other AI assistants to access your LinkedIn. Scrape LinkedIn profiles and companies, get your recommended jobs, and perform...
An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP