Construir Agentes Com Servidor Needle Mcp

O que é Needle-MCP?

Needle-MCP é uma integração inovadora do framework Needle dentro do Protocolo de Contexto de Modelo (MCP). Este repositório serve como um recurso público para desenvolvedores e pesquisadores interessados em aproveitar as capacidades do Needle em seus projetos. O framework Needle foi projetado para melhorar o desempenho do modelo e agilizar o processo de desenvolvimento, tornando-se uma ferramenta valiosa para aplicações de aprendizado de máquina e IA.

Recursos do Needle-MCP

Integração Sem Costura: Needle-MCP permite uma fácil integração do framework Needle em projetos existentes, facilitando um fluxo de trabalho mais suave para os desenvolvedores.
Desempenho Aprimorado: Ao utilizar o Needle, os usuários podem esperar um desempenho melhorado do modelo, levando a previsões mais precisas e melhores resultados gerais.
Repositório Público: Sendo um repositório público, o Needle-MCP incentiva a colaboração e contribuições da comunidade, promovendo inovação e compartilhamento de conhecimento.
Documentação e Suporte: Documentação abrangente está disponível para guiar os usuários na instalação e uso do Needle-MCP, garantindo que os desenvolvedores possam começar rapidamente.

Como Usar o Needle-MCP

Clone o Repositório: Comece clonando o repositório Needle-MCP para sua máquina local usando o Git.
```
git clone https://github.com/needle-ai/needle-mcp.git
```
Instale Dependências: Navegue até o diretório clonado e instale as dependências necessárias.
```
cd needle-mcp
pip install -r requirements.txt
```
Integre com Seu Modelo: Siga a documentação fornecida para integrar o Needle ao seu contexto de modelo. Isso pode envolver a modificação do código do seu modelo para utilizar efetivamente os recursos do Needle.
Execute Seu Modelo: Após a integração, execute seu modelo como de costume e observe as melhorias de desempenho facilitadas pelo Needle.

Perguntas Frequentes

Qual é o propósito do Needle-MCP?

O Needle-MCP tem como objetivo fornecer aos desenvolvedores um framework robusto para aprimorar o desempenho do modelo através da integração do Needle dentro do Protocolo de Contexto de Modelo.

O Needle-MCP é adequado para todos os tipos de modelos?

Sim, o Needle-MCP foi projetado para ser versátil e pode ser integrado a vários tipos de modelos de aprendizado de máquina, tornando-o adequado para uma ampla gama de aplicações.

Como posso contribuir para o Needle-MCP?

Contribuições são bem-vindas! Você pode contribuir enviando problemas, solicitações de recursos ou pull requests no repositório do GitHub. A colaboração é incentivada para melhorar ainda mais o framework.

Onde posso encontrar a documentação do Needle-MCP?

A documentação está disponível dentro do próprio repositório, tipicamente em uma pasta docs ou como um arquivo README. Ela fornece instruções detalhadas sobre instalação, uso e exemplos.

Qual licença o Needle-MCP utiliza?

O Needle-MCP é licenciado sob a Licença MIT, permitindo tanto uso pessoal quanto comercial, desde que a devida atribuição seja dada.

Build Agents with Needle MCP Server

Screenshot of Feature - Claude

MCP (Model Context Protocol) server to manage documents and perform searches using Needle through Claude’s Desktop Application.

Overview
Features
Usage
- Commands in Claude Desktop
- Result in Needle
Installation
Video Explanation

Overview

Needle MCP Server allows you to:

Organize and store documents for quick retrieval.
Perform powerful searches via Claude’s large language model.
Integrate seamlessly with the Needle ecosystem for advanced document management.

Features

Document Management: Easily add and organize documents on the server.
Search & Retrieval: Claude-based natural language search for quick answers.
Easy Integration: Works with Claude Desktop and Needle collections.

Usage

Commands in Claude Desktop

Below is an example of how the commands can be used in Claude Desktop to interact with the server:

Using commands in Claude Desktop

Open Claude Desktop and connect to the Needle MCP Server.
Use simple text commands to search, retrieve, or modify documents.
Review search results returned by Claude in a user-friendly interface.

Result in Needle

https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c

Youtube Video Explanation

For a full walkthrough on using the Needle MCP Server with Claude and Claude Desktop, watch this YouTube explanation video.

Installation

Installing via Smithery

To install Needle MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install needle-mcp --client claude

Manual Installation

Clone the repository:

git clone https://github.com/yourusername/needle-mcp.git

Install UV globally using Homebrew in Terminal:

brew install uv

Create claude_desktop_config.json:
- For MacOS: Open directory ~/Library/Application Support/Claude/ and create the file inside it
- For Windows: Open directory %APPDATA%/Claude/ and create the file inside it
Add this configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}

Get your Needle API key from needle.xyz
Update the config file:
- Replace /path/to/needle-mcp with your actual repository path
- Add your Needle API key
Quit Claude completely and reopen it

Usage Examples

"Create a new collection called 'Technical Docs'"
"Add this document to the collection, which is https://needle-ai.com"
"Search the collection for information about AI"
"List all my collections"

Troubleshooting

If not working:

Make sure UV is installed globally (if not, uninstall with pip uninstall uv and reinstall with brew install uv)
Or find UV path with which uv and replace "command": "uv" with the full path
Verify your Needle API key is correct
Check if the needle-mcp path in config matches your actual repository location

Reset Claude Desktop Configuration

If you're seeing old configurations or the integration isn't working:

Find all Claude Desktop config files:

find / -name "claude_desktop_config.json" 2>/dev/null

Remove all Claude Desktop data:

On MacOS: rm -rf ~/Library/Application\ Support/Claude/*
On Windows: Delete contents of %APPDATA%/Claude/

Create a fresh config with only Needle:

mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
<< 'EOL'
{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL

Completely quit Claude Desktop (Command+Q on Mac) and relaunch it
If you still see old configurations:

Check for additional config files in other locations
Try clearing browser cache if using web version
Verify the config file is being read from the correct location

Configuração do Servidor

{
  "mcpServers": {
    "needle-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/metorial/mcp-container--needle-ai--needle-mcp--needle-mcp",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "needle-api-key"
      }
    }
  }
}

Informações do Projeto

Autor

needle-ai

Construir Agentes Co... Alternativa

Para algumas alternativas a Construir Agentes Co... que você pode precisar, fornecemos sites divididos por categoria.

Metoro Mcp Server

@metoro-io

Metoro MCP Servidor

Ferramentas de Desenvolvedor

Notion Mcp Server

@makenotion

Servidor MCP Oficial do Notion

Ferramentas de Desenvolvedor

Forevervm

@jamsocket

Execute com segurança código gerado por IA em sandboxes com estado que funcionam indefinidamente.

Ferramentas de Desenvolvedor

Refatorar Agente de Desenvolvimento de Software de IA Open Source

@smallcloudai

Agente de IA que lida com tarefas de engenharia de ponta a ponta: integra-se às ferramentas dos desenvolvedores, planeja, executa e itera até alcançar um resultado bem-sucedido.

Ferramentas de Desenvolvedor

Servidor Dart Mcp

@its-dart

Servidor do Protocolo de Contexto do Modelo de IA Dart (MCP)

Ferramentas de Desenvolvedor

Criar Servidor Mcp (legado) Passo 1: Baixar o Software 1. Acesse o site oficial do MCP. 2. Baixe a versão mais recente do servidor legado. Passo 2: Instalar o Servidor 1. Extraia os arquivos baixados para uma pasta de sua escolha. 2. Abra o terminal ou prompt de comando. 3. Navegue até a pasta onde os arquivos foram extraídos. Passo 3: Configurar o Servidor 1. Localize o arquivo `server.properties`. 2. Edite as configurações conforme necessário (por exemplo, nome do servidor, número máximo de jogadores). Passo 4: Iniciar o Servidor 1. No terminal, execute o comando para iniciar o servidor. 2. Aguarde até que o servidor esteja totalmente carregado. Passo 5: Conectar ao Servidor 1. Abra o jogo MCP. 2. Vá para a opção de multiplayer. 3. Adicione o endereço IP do servidor e conecte-se. Passo 6: Gerenciar o Servidor 1. Use comandos no terminal para gerenciar o servidor. 2. Monitore o desempenho e faça ajustes conforme necessário. Dicas Finais - Certifique-se de que as portas necessárias estão abertas no seu roteador. - Faça backup dos arquivos do servidor regularmente.

@integromat

Criar Servidor MCP Passo 1: Preparar o Ambiente 1. Instalar Java: Certifique-se de que você tem o Java instalado. Você pode baixar a versão mais recente do [site oficial do Java](https://www.java.com/). 2. Baixar MCP: Vá para o [site do MCP](http://mcp.ocean-labs.de/) e baixe a versão mais recente do MCP. Passo 2: Configurar o MCP 1. Extrair o MCP: Extraia o arquivo baixado em uma pasta de sua escolha. 2. Configurar o MCP: Navegue até a pasta extraída e abra o arquivo `mcp.cfg`. Edite as configurações conforme necessário. Passo 3: Compilar o MCP 1. Abrir o Terminal: Abra o terminal ou prompt de comando. 2. Navegar até a Pasta do MCP: Use o comando `cd` para navegar até a pasta onde você extraiu o MCP. 3. Executar o Script de Compilação: Execute o comando `./decompile.sh` (Linux/Mac) ou `decompile.bat` (Windows) para compilar o MCP. Passo 4: Iniciar o Servidor 1. Navegar até a Pasta do Servidor: Vá para a pasta `server` dentro da pasta do MCP. 2. Iniciar o Servidor: Execute o comando `java -Xmx1024M -Xms1024M -jar minecraft_server.jar nogui` para iniciar o servidor. Passo 5: Conectar ao Servidor 1. Abrir o Minecraft: Inicie o jogo Minecraft. 2. Adicionar Servidor: Vá para "Multiplayer" e clique em "Adicionar Servidor". Insira o endereço do servidor (geralmente `localhost` se estiver jogando na mesma máquina). 3. Conectar: Clique em "Conectar" para entrar no servidor. Passo 6: Configurações Adicionais 1. Configurar o `server.properties`: Edite o arquivo `server.properties` para ajustar as configurações do servidor, como o nome do mundo e as regras do jogo. 2. Instalar Mods (opcional): Se desejar, você pode instalar mods para personalizar ainda mais seu servidor. Conclusão Agora você tem um servidor MCP funcionando! Divirta-se jogando com seus amigos!

Ferramentas de Desenvolvedor