AI导哈

苏丹数字档案馆MCP服务器

一个用于苏丹数字档案馆API的模型上下文协议（MCP）服务器，支持藏品检索、元数据管理和自动化操作，适用于Gemini CLI或Claude Code等MCP兼容环境。

  • by Sudan-Digital-Archive
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 Sudan-Digital-Archive/mcp-server

使用说明

Sudan Digital Archive MCP Server

This is a Model Context Protocol (MCP) server for the Sudan Digital Archive (SDA). It provides tools to interact with the SDA API, allowing for automations and enhanced search capabilities within MCP-compatible environments like Gemini CLI or Claude Code.

Features

  • List and search public and private accessions.
  • Retrieve detailed metadata for specific accessions.
  • Manage metadata subjects (list, create, delete).
  • Update accession details.

Getting Started

Prerequisites

  • Rust (latest stable version)
  • An API Key for the Sudan Digital Archive.

Building from Source

You are expected to build the binary yourself for your specific platform:

cargo build --release

The resulting binary will be located at target/release/sda-mcp-server.

Install

macOS & Linux:

curl -fsSL https://raw.githubusercontent.com/Sudan-Digital-Archive/mcp-server/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/Sudan-Digital-Archive/mcp-server/main/install.ps1 | iex

Configuration

You can configure the server using command-line arguments or environment variables.

  • --api-key or SDA_API_KEY: Your SDA API key.
  • --base-url: (Optional) The base URL for the SDA API.

Integration Example (Gemini/Claude)

To use this server with an MCP client, add it to your configuration. Here is an example for Gemini:

{
  "mcpServers": {
    "sudan-digital-archive": {
      "command": "sda-mcp-server",
      "args": [
        "--api-key", "YOUR_API_KEY_HERE"
      ],
      "env": {
        "SDA_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Note on MCP Compatibility

Model Context Protocol is a developing standard. During development, I observed that some MCP clients have issues consuming JSON schemas that use complex optional types (e.g., Option<T> in Rust translating to anyOf: [..., { "type": "null" }]).

To maximize compatibility with current MCP clients, we have intentionally avoided using optional types for tool arguments, preferring default values (like -1 for pagination or empty strings) where appropriate. This area may be updated in the future as MCP client implementations mature.

Development

The project includes a GitHub workflow for CI/CD:

  • Quality Assurance: Runs formatting, linting, and compilation checks on every PR and push to main.
  • Automated Releases: Automatically builds and publishes binaries to GitHub Releases when the version in Cargo.toml is updated on the main branch.

相关 MCP