Axiom MCP服务器
Axiom个人知识助理的MCP（模型上下文协议）服务器实现。
服务器状态
| 服务器 | 状态 | 描述 |
|---|---|---|
| 文件系统 | ✅ 完成 | 本地文件访问 |
| GitHub | 🔲 第6阶段 | GitHub存储库访问 |
| 谷歌云端硬盘 | 🔲 未来 | 谷歌云端硬盘访问 |
文件系统服务器（完整）
使用FastMCP访问本地文件系统的完整MCP服务器。
特性
工具：
| 工具 | 说明 |
|---|---|
list_allowed_directories | 显示已配置的目录 |
list_directory | 使用可选递归浏览文件 |
read_file | 使用元数据获取文件内容 |
search_files | 按模式和/或内容查找文件 |
get_file_info | 获取文件元数据 |
资源：
| URI | 描述 |
|---|---|
file:///{path} | 按绝对路径读取文件 |
安全：
- 可配置的允许目录
- 忽略模式（node_modules、.git、.git等）， __\_\_pycache\_\___等等）
- 支持的扩展白名单
- 只读访问
快速开始
cd axiom-mcp-servers
# Create virtual environment
python -m venv .venv
source .venv/bin/activate
# Install dependencies
pip install -e ".[dev]"
# Run tests
cd servers/filesystem
python -m pytest test_server.py -v
# Start server
python server.py配置
编辑 servers/filesystem/config.yaml:
allowed_directories:
- ~/Documents
- ~/projects
ignore_patterns:
- "*/node_modules/*"
- "*/.git/*"
supported_extensions:
- .py
- .md
- .json与MCP客户端一起使用
添加到您的MCP客户端配置中（例如，Claude Desktop）：
{
"mcpServers": {
"filesystem": {
"command": "python",
"args": ["/path/to/axiom-mcp-servers/servers/filesystem/server.py"]
}
}
}GitHub服务器（第6阶段）
GitHub存储库访问的占位符。将在第六阶段实施。
计划功能：
- 列出已配置的存储库
- 从存储库读取文件
- 在仓库中搜索代码
- 获取存储库树结构
项目结构
axiom-mcp-servers/
├── shared/ # Common utilities
│ ├── base_server.py # Abstract base class
│ └── utils.py # File type detection
│
├── servers/
│ ├── filesystem/ # ✅ Complete
│ │ ├── server.py # MCP server implementation
│ │ ├── config.yaml # Configuration
│ │ ├── test_server.py # Unit tests
│ │ └── README.md # Documentation
│ │
│ ├── github/ # 🔲 Phase 6
│ │ ├── server.py # Placeholder
│ │ └── config.yaml # Configuration
│ │
│ └── gdrive/ # 🔲 Future
│ └── README.md # Placeholder
│
└── tests/
└── integration/相关项目
许可证
MIT许可证